-
documentation clarity standards
remix-run/react-router30⭐ 55270Ensure all React-related documentation, comments, and descriptions maintain high standards of clarity, accu...
-
Use runServerless utility
serverless/serverless25⭐ 46810All new tests must be written using the `runServerless` utility instead of legacy testing approaches. This ...
-
Complete locale translations
RooCodeInc/Roo-Code25⭐ 17288Ensure that all text strings in locale-specific files are properly translated into their respective languag...
-
Use environment variables
hashicorp/terraform21⭐ 45532When working with configurations that require sensitive data (credentials, tokens, passwords), always use e...
-
reduce complexity for readability
servo/servo20⭐ 32962Prioritize code readability by reducing complexity through better organization and clearer patterns. Use ea...
-
Prevent sensitive data exposure
bridgecrewio/checkov20⭐ 7667Never log or store sensitive information (passwords, tokens, secrets) in clear text. This common security v...
-
Use descriptive names
strands-agents/sdk-python19⭐ 4044Choose names that clearly convey purpose and intent rather than generic or ambiguous terms. Names should be...
-
API authentication requirements
langflow-ai/langflow19⭐ 111046Ensure all API documentation and code examples include proper authentication headers and clearly explain au...
-
configuration value consistency
traefik/traefik18⭐ 55772Ensure configuration values follow consistent formats, use meaningful defaults, and accurately distinguish ...
-
Complete network configurations
traefik/traefik17⭐ 55772Network configuration examples and documentation should include all essential networking components such as...
-
Optimize allocation hotspots
netty/netty17⭐ 34227Identify and optimize object allocation in performance-critical paths by applying appropriate allocation st...
-
Configuration documentation clarity
langflow-ai/langflow17⭐ 111046Ensure configuration documentation clearly distinguishes between deployment contexts and uses consistent te...
-
no braces short ifs
hyprwm/Hyprland17⭐ 28863Remove braces around single-statement if blocks to maintain consistent code style and improve readability. ...
-
Use meaningful names
juspay/hyperswitch17⭐ 34028Use descriptive, self-explanatory names for variables, methods, fields, and types. Avoid single-letter vari...
-
optimize database operations
apache/spark16⭐ 41554When working with database operations, prioritize batching multiple statements and pushing operations down ...
-
Use descriptive semantic names
serverless/serverless16⭐ 46810Variable and function names should clearly communicate their purpose, type, and scope without requiring add...
-
Validate boundary conditions
rust-lang/rust16⭐ 105254Ensure algorithms handle boundary conditions and edge cases correctly by adding explicit validation for all...
-
documentation formatting consistency
nuxt/nuxt16⭐ 57769Ensure consistent formatting throughout documentation by applying these standards: wrap code terms, variabl...
-
Comprehensive test coverage
kubernetes/kubernetes16⭐ 116489Ensure comprehensive test coverage by systematically considering all scenarios, edge cases, and feature com...
-
Extract for clarity
elastic/elasticsearch16⭐ 73104Extract complex or reused logic into focused, well-named methods with single responsibilities. This improve...
-
Protect sensitive data
bridgecrewio/checkov16⭐ 7668Never log, display, or store sensitive information like passwords, tokens, or secrets in clear text. This c...
-
Comprehensive documentation standards
tokio-rs/axum16⭐ 22100Create clear, well-structured API documentation following proper formatting, correct references, informativ...
-
Use descriptive names
vlang/v15⭐ 36582Choose variable, function, and parameter names that clearly communicate their purpose and avoid confusion. ...
-
realistic documentation examples
sveltejs/svelte15⭐ 83580Use practical, complete examples in documentation rather than oversimplified or contrived ones that cut cor...
-
Avoid code duplication
BerriAI/litellm15⭐ 28310Eliminate redundant code by leveraging existing utilities, extracting reusable helper functions, and organi...
-
Organize code structure
juspay/hyperswitch15⭐ 34028Maintain clean and well-organized code structure by following consistent organizational patterns. This impr...
-
Explain non-obvious code
flutter/flutter15⭐ 172252Add explanatory comments for any code that isn't immediately self-explanatory, including magic numbers, imp...
-
Use specific assertion methods
fastify/fastify15⭐ 34000Choose the appropriate assertion method based on the data type being tested. This improves test readability...
-
Database type consistency
drizzle-team/drizzle-orm15⭐ 29461Ensure database-specific types, imports, and serialization are used consistently throughout the codebase. T...
-
Use descriptive, unambiguous names
bazelbuild/bazel15⭐ 24489Choose names that clearly communicate their purpose and avoid ambiguity or misinterpretation. Names should ...
-
Simplify complex code
bazelbuild/bazel15⭐ 24489Break down complex code structures into simpler, more readable forms to improve maintainability and reduce ...
-
Consistent terminology propagation
appwrite/appwrite15⭐ 51959When changing terminology or naming conventions in a codebase, ensure complete and consistent propagation a...
-
eliminate unnecessary code
Unstructured-IO/unstructured14⭐ 12116Remove redundant operations, unnecessary code blocks, and verbose constructs to improve code clarity and ma...
-
Optimize regex patterns
getsentry/sentry-php14⭐ 1873When using regular expressions, optimize for both performance and precision to ensure efficient and accurat...
-
Internationalize all text
RooCodeInc/Roo-Code14⭐ 17288All user-facing text must be wrapped with translation functions instead of using hardcoded English strings....
-
Consistent naming patterns
octokit/octokit.net14⭐ 2793Follow consistent naming conventions throughout the codebase to improve readability and maintainability: 1...
-
Guard against null
n8n-io/n8n14⭐ 122978Always use optional chaining (`?.`) and nullish coalescing (`??`) operators when accessing potentially unde...
-
Handle async operation errors
elie222/inbox-zero14⭐ 8267Always wrap asynchronous operations in try-catch-finally blocks to prevent unhandled promise rejections and...
-
Keep CI configurations minimal
laravel/framework14⭐ 33763When configuring CI workflows, include only the extensions, tools, and settings that are necessary for the ...
-
SQLAlchemy 2.0 patterns
langgenius/dify14⭐ 114231Migrate from legacy SQLAlchemy 1.x query patterns to modern 2.0 style for better performance, clarity, and ...
-
Consistent naming standards
home-assistant/core14⭐ 80450Ensure all user-facing strings follow Home Assistant's naming conventions for consistency and proper intern...
-
Configuration validation messages
cloudflare/workers-sdk13⭐ 3379Ensure configuration validation provides clear, actionable error messages that guide users toward correct c...
-
avoid expensive repeated operations
vlang/v13⭐ 36582Cache results of expensive computations and order operations from cheapest to most expensive to minimize pe...
-
Add comprehensive test coverage
vlang/v13⭐ 36582When adding functionality or fixing bugs, always add new test functions rather than modifying existing ones...
-
Enforce scope boundaries
gravitational/teleport13⭐ 19109When implementing hierarchical permission systems with scopes, ensure that permissions granted at a specifi...
-
Spring code style
spring-projects/spring-framework13⭐ 58382Follow Spring Framework's code style guidelines to ensure consistency across the codebase. Key rules includ...
-
Use semantically accurate names
servo/servo13⭐ 32962Variable, method, and type names should accurately reflect their actual purpose, content, and behavior. Avo...
-
Consistent descriptive naming
prometheus/prometheus13⭐ 59616Ensure variable, function, and type names are consistent, descriptive, and follow Go naming conventions. Na...
-
Code for readability
opencv/opencv13⭐ 82865Prioritize human readability when writing code. Split complex expressions into steps with meaningful variab...
-
Descriptive consistent naming
ghostty-org/ghostty13⭐ 32864Use descriptive, consistent naming that follows language and platform conventions. Choose names that clearl...
-
Use descriptive names
flutter/flutter13⭐ 172252Names should clearly describe what they represent or do, rather than how they're implemented or using gener...
-
API parameter consistency
electron/electron13⭐ 117644Ensure consistent parameter handling across API methods by using appropriate defaults, proper type conversi...
-
Clean up your code
deeplearning4j/deeplearning4j13⭐ 14036Maintain clean, professional code by removing development artifacts and improving readability: 1. **Remove...
-
Use descriptive contextual names
alacritty/alacritty13⭐ 59675Choose variable, function, and struct names that clearly communicate their purpose and content while consid...
-
Design interfaces, not implementations
zed-industries/zed12⭐ 62119Create intuitive API interfaces that abstract away implementation details while providing a consistent expe...
-
Use testify assertion libraries
vitessio/vitess12⭐ 19815Replace manual if-error checks with `testify`'s `assert` and `require` packages to make tests more readable...
-
Use semantically clear names
Unstructured-IO/unstructured12⭐ 12117Choose variable, method, and class names that clearly express their purpose and functionality to avoid conf...
-
simplify control flow patterns
twentyhq/twenty12⭐ 35477Improve code readability by simplifying control flow structures and avoiding unnecessary complexity. This i...
-
Simplify complex expressions
tree-sitter/tree-sitter12⭐ 21799Break down complex code structures into simpler, more readable forms. This includes avoiding deep nesting, ...
-
Configuration validation consistency
traefik/traefik12⭐ 55772Ensure configuration fields use consistent validation patterns, appropriate data types, and proper bounds c...
-
Use semantic naming
microsoft/terminal12⭐ 99242Names should clearly communicate their purpose, type, and behavior to improve code maintainability and acce...
-
Guide structure consistency
gravitational/teleport12⭐ 19109Documentation guides should follow a consistent structure and provide clear, descriptive content to improve...
-
consistent descriptive naming
SigNoz/signoz12⭐ 23369Use meaningful, descriptive names that clearly convey purpose and maintain consistency across similar conce...
-
eliminate code duplication
sgl-project/sglang12⭐ 17245Actively identify and eliminate code duplication by extracting common patterns into reusable components. Wh...
-
API consistency patterns
remix-run/react-router12⭐ 55270Ensure API design follows consistent patterns for naming, typing, and composition to improve developer expe...
-
Parameterize similar tests
python-poetry/poetry12⭐ 33496Use `pytest.mark.parametrize` to consolidate similar test cases instead of duplicating test code. This appr...
-
Component naming consistency
n8n-io/n8n12⭐ 122978Ensure component usage in templates matches registered components. Vue components must be referenced in tem...
-
Clean and consistent code
n8n-io/n8n12⭐ 122978Maintain clean and consistent code by removing unnecessary elements and following standard practices: 1. *...
-
Eliminate redundant constructs
apache/mxnet12⭐ 20801Remove unnecessary coding patterns that add complexity without providing value. Focus on clarity and simpli...
-
Model specification accuracy
lobehub/lobe-chat12⭐ 65138Ensure AI model configurations accurately reflect official specifications and avoid hardcoded assumptions. ...
-
prefer OpenAI compatibility
BerriAI/litellm12⭐ 28310When integrating new LLM providers or AI services, prioritize OpenAI-compatible patterns and reuse existing...
-
Mock tests in tests/litellm
BerriAI/litellm12⭐ 28310All new functionality must include mock tests placed in the `tests/litellm/` directory structure. Mock exte...
-
Use descriptive names
istio/istio12⭐ 37192Names should accurately reflect their actual functionality and behavior. Avoid misleading or vague identifi...
-
consistent highlighting patterns
helix-editor/helix12⭐ 39026Maintain consistency in syntax highlighting patterns by using appropriate, specific scopes and avoiding ove...
-
Use extensible parameter objects
electron/electron12⭐ 117644When designing APIs that may need additional parameters in the future, use objects instead of individual pa...
-
Provide contextual explanations
electron/electron12⭐ 117644Documentation should explain not just what APIs and features do, but when, why, and how to use them. Provid...
-
Use descriptive identifiers
discourse/discourse12⭐ 44898Choose names that clearly communicate purpose and reduce cognitive load for future readers. Avoid generic, ...
-
Follow existing naming patterns
docker/compose12⭐ 35858Maintain consistency with established naming conventions throughout the codebase. When adding new flags, fu...
-
consistent readable patterns
snyk/cli12⭐ 5178Maintain consistent coding patterns and prioritize readability to make code easier to understand and mainta...
-
Limit token permissions
chef/chef12⭐ 7860Always specify the minimum required permissions for the GITHUB_TOKEN in GitHub Actions workflows to enhance...
-
Maintain consistent style
oven-sh/bun12⭐ 79093Maintain consistent style patterns throughout the codebase to improve readability, reduce maintenance overh...
-
Follow support tiers
Homebrew/brew12⭐ 44168Configure your Homebrew installation according to the defined support tiers to ensure optimal functionality...
-
maintain consistent style
angular/angular12⭐ 98611Ensure consistent application of coding style conventions throughout the codebase, including naming pattern...
-
Use descriptive naming
volcano-sh/volcano11⭐ 4899Choose variable, function, and method names that clearly communicate their purpose and behavior. Avoid ambi...
-
Optimize algorithmic efficiency
volcano-sh/volcano11⭐ 4899Choose efficient algorithms and data structures to minimize computational overhead and improve code maintai...
-
Eliminate code redundancy
vllm-project/vllm11⭐ 51730Keep your codebase maintainable by eliminating both unnecessary and duplicated code: 1. **Remove debugging...
-
PEP 257 docstring compliance
Unstructured-IO/unstructured11⭐ 12116All public modules, classes, methods, and functions must have docstrings that follow PEP 257 formatting sta...
-
explicit None handling
Unstructured-IO/unstructured11⭐ 12116Always handle potential None values explicitly through defensive programming patterns, proper type annotati...
-
Minimize allocation hotspots
spring-projects/spring-framework11⭐ 58382Reduce object creation in performance-critical paths by carefully evaluating allocation patterns. For frequ...
-
Improve code organization
sgl-project/sglang11⭐ 17245Prioritize clean code structure and readability in AI/ML codebases by avoiding inline conditionals, using d...
-
optimize algorithmic complexity
servo/servo11⭐ 32962Prioritize algorithmic efficiency by choosing operations and data structures that minimize computational co...
-
comprehensive API documentation
servo/servo11⭐ 32962All public items, struct fields, and methods must have comprehensive documentation. When implementing web s...
-
Split for better readability
getsentry/sentry-php11⭐ 1873Break long lines and complex structures across multiple lines to improve code readability. Follow these gui...
-
require module documentation
semgrep/semgrep11⭐ 12598All modules containing functions should have corresponding .mli files with comprehensive documentation. The...
-
Optimize for readability
dotnet/runtime11⭐ 16578Write code that clearly communicates intent by using appropriate naming and formatting techniques. Improve ...
-
Device-agnostic acceleration code
pytorch/pytorch11⭐ 91345Avoid hardcoding specific device types like 'cuda' in AI code. Instead, use device-agnostic approaches such...
-
maintain code consistency
emcie-co/parlant11⭐ 12205Ensure consistent patterns, formatting, and conventions throughout the codebase. Inconsistencies in code st...
-
Craft actionable errors
opentofu/opentofu11⭐ 25901Create error messages that provide precise context, avoid unnecessary details, and give users clear actions...
-
precise language usage
nuxt/nuxt11⭐ 57769Use precise, natural language in documentation to improve clarity and readability. Focus on accurate word c...
-
Idempotent error-safe disposers
nodejs/node11⭐ 112178When implementing resource cleanup logic, especially disposers for explicit resource management, always des...
-
Follow modern C++ guidelines
maplibre/maplibre-native11⭐ 1411Adhere to the C++ Core Guidelines for improved code quality, readability, and maintainability. Follow these...
-
consolidate algorithmic patterns
ggml-org/llama.cpp11⭐ 83559Avoid duplicating similar algorithmic logic across multiple functions by consolidating them into generic, t...
-
AI model data validation
BerriAI/litellm11⭐ 28310All AI model configuration parameters must be verified against official provider documentation before mergi...
-
Organize documentation content
langflow-ai/langflow11⭐ 111046Structure documentation to prevent information overload and improve readability by using appropriate organi...
-
Use semantically clear names
kubernetes/kubernetes11⭐ 116489Choose names that accurately reflect the actual functionality, purpose, or semantic meaning rather than usi...
-
Feature gate field preservation
kubernetes/kubernetes11⭐ 116489When implementing feature-gated fields, always preserve existing field values when the feature gate is disa...
-
Names express clear intent
JetBrains/kotlin11⭐ 50857Choose names that clearly express intent and follow established conventions. Prefer explicit, descriptive n...
-
comprehensive test coverage
apache/kafka11⭐ 30575Ensure tests cover not only the happy path but also edge cases, error scenarios, and complete workflows. Ma...
-
consistent command flag design
jj-vcs/jj11⭐ 21171Design command-line interfaces with consistent flag semantics and leverage framework features for validatio...
-
Sanitize all inputs
elie222/inbox-zero11⭐ 8267Properly sanitize or escape all user-provided inputs before using them in sensitive contexts to prevent inj...
-
explicit error handling
juspay/hyperswitch11⭐ 34028Avoid catch-all patterns and implicit error handling. Handle each error case explicitly, use the ? operator...
-
Use descriptive naming
duckdb/duckdb11⭐ 32061Choose names that clearly communicate intent and purpose rather than being generic, abbreviated, or potenti...
-
Use descriptive names
duckdb/duckdb11⭐ 32061Names should be descriptive and unambiguous, clearly communicating their purpose and intent. Avoid abbrevia...
-
Use descriptive names
stanfordnlp/dspy11⭐ 27813Choose variable, method, class, and parameter names that clearly communicate their purpose and avoid ambigu...
-
Mock external dependencies only
home-assistant/core11⭐ 80450When writing tests for Home Assistant integrations, mock external library dependencies rather than Home Ass...
-
Use descriptive semantic names
ClickHouse/ClickHouse11⭐ 42425Names should accurately reflect their purpose, behavior, and semantic meaning to avoid confusion and improv...
-
Avoid unnecessary allocations
ClickHouse/ClickHouse11⭐ 42425Minimize memory allocations, data copying, and expensive operations by implementing early exits, using move...
-
Add explanatory comments
bazelbuild/bazel11⭐ 24489Add explanatory comments and documentation for complex logic, non-obvious code behavior, method parameters,...
-
Standardize platform-agnostic configuration
zed-industries/zed10⭐ 62119Ensure configuration handling is consistent and platform-agnostic by following these guidelines: 1. Use en...
-
prioritize code clarity
cloudflare/workerd10⭐ 6989Write code that prioritizes readability and clarity over minor optimizations or clever shortcuts. When face...
-
Validate nullability with types
microsoft/vscode10⭐ 174887Always handle null and undefined values explicitly through proper type declarations and validation patterns...
-
Document code thoroughly
vllm-project/vllm10⭐ 51730Always include comprehensive documentation for your code through both docstrings and explanatory comments. ...
-
Improve code clarity
vlang/v10⭐ 36582Write code that clearly expresses intent through explicit patterns, simplified logic, and readable structur...
-
prioritize code clarity
unionlabs/union10⭐ 74800Write code that prioritizes readability and explicitness over brevity. This includes using explicit type co...
-
Configuration documentation clarity
astral-sh/ty10⭐ 11919Configuration documentation should be precise, specific, and include helpful context for users. Avoid vague...
-
Use proper types
tensorflow/tensorflow10⭐ 190625Maintain code clarity by using appropriate type declarations and parameter passing conventions: 1. **Prefe...
-
Organize code by functionality
gravitational/teleport10⭐ 19109Structure code based on what it does rather than how it's implemented. Group related functionality together...
-
Complete API documentation
spring-projects/spring-framework10⭐ 58382Documentation should be complete, accurate, and follow Spring Framework conventions. Ensure your Javadocs i...
-
Purposeful documentation standards
getsentry/sentry-php10⭐ 1873Documentation should convey purpose and behavior, not just replicate code structure. Each docblock should e...
-
Standardize configuration paths
quarkusio/quarkus10⭐ 14667Follow consistent patterns for storing and referencing configuration files across projects. Place custom co...
-
Next.js directory structure
prowler-cloud/prowler10⭐ 11834Keep the Next.js `/app` directory strictly for routing purposes as per framework conventions. Non-routing r...
-
simplify complex algorithms
prometheus/prometheus10⭐ 59616When implementing algorithms, prioritize simplicity and maintainability over premature optimization. Comple...
-
Safe null handling
pola-rs/polars10⭐ 34296Always implement robust null handling patterns to prevent unexpected behavior and crashes. Consider all edg...
-
Extract duplicated code
pola-rs/polars10⭐ 34296Identify and extract duplicated code into reusable functions or move common fields to parent structures. Th...
-
prefer simple readable code
python-poetry/poetry10⭐ 33496Write code that prioritizes clarity and simplicity over cleverness. This improves maintainability and reduc...
-
Use descriptive identifier names
microsoft/playwright10⭐ 76113Choose specific, descriptive names for variables, methods, types, and other identifiers that clearly commun...
-
Consistent descriptive naming
opencv/opencv10⭐ 82865Use clear, descriptive names that follow consistent patterns established in the codebase and broader progra...
-
configuration resolution patterns
nuxt/nuxt10⭐ 57769When defining configuration schemas, use consistent patterns for safe property access, async resolution, an...
-
type-safe database operations
rocicorp/mono10⭐ 2091Implement proper type conversion and validation when working with different database systems to prevent run...
-
Avoid unnecessary auto
llvm/llvm-project10⭐ 33702Use explicit types instead of `auto` unless the type is obvious from the right-hand side of the assignment ...
-
TypeScript naming standards
langchain-ai/langchainjs10⭐ 15004Follow consistent naming conventions in TypeScript to improve code clarity, type safety, and developer expe...
-
simplify code structure
kubernetes/kubernetes10⭐ 116489Prioritize code simplification by removing unnecessary complexity, avoiding duplication, and leveraging exi...
-
Define technical terms clearly
jj-vcs/jj10⭐ 21171Always define technical terms and concepts explicitly in documentation rather than assuming reader knowledg...
-
Handle errors with care
elie222/inbox-zero10⭐ 8267Always implement comprehensive error handling for asynchronous operations, external API calls, and database...
-
Minimize allocations and syscalls
helix-editor/helix10⭐ 39026Optimize performance by minimizing unnecessary memory allocations and system calls. Key practices: 1. Avoi...
-
AI model integration patterns
google-gemini/gemini-cli10⭐ 65062When integrating with AI models and LLMs, structure your code to properly handle model responses, separate ...
-
Optimize for code readability
laravel/framework10⭐ 33763Prioritize code readability over clever solutions by: 1. Using early returns to reduce nesting 2. Leveragin...
-
optimize algorithmic efficiency
electron/electron10⭐ 117644Choose efficient data structures and algorithms to minimize computational overhead and improve performance....
-
Use descriptive names
langgenius/dify10⭐ 114231Choose names that clearly describe the purpose, behavior, or content of variables, methods, and classes. Av...
-
Safe null handling
langgenius/dify10⭐ 114231Handle null and undefined values safely by using appropriate fallback patterns, validating critical paramet...
-
organize code structure
denoland/deno10⭐ 103714Maintain clean code organization by moving implementation details to appropriate locations, extracting reus...
-
Centralize dependency management
deeplearning4j/deeplearning4j10⭐ 14036Manage dependencies at the top level using `
` to ensure version consistency across mo... -
Graceful error handling
snyk/cli10⭐ 5178Implement robust error handling that provides fallback mechanisms, ensures proper resource cleanup, and del...
-
Restrict public access
bridgecrewio/checkov10⭐ 7667Cloud resources should be configured to restrict public network access by default to minimize potential att...
-
Extract focused functions
bridgecrewio/checkov10⭐ 7667Break down complex logic into small, well-named functions that each do one thing well. This improves code r...
-
Consistent naming conventions
bridgecrewio/checkov10⭐ 7668Maintain consistent naming patterns throughout the codebase to improve readability and reduce confusion: 1...
-
Prefer explicit nil handling
Homebrew/brew10⭐ 44168Handle nil values explicitly and consistently to improve code clarity and type safety. Follow these guideli...
-
consistent configuration handling
better-auth/better-auth10⭐ 19651Ensure configuration options are handled uniformly across all API endpoints and providers. Configuration sh...
-
Type-safe flexible APIs
tokio-rs/axum10⭐ 22100Design APIs that favor both type safety and flexibility. Use strongly typed wrappers instead of primitive t...
-
Validate environment variables
appwrite/appwrite10⭐ 51959Always validate environment variables before use and implement proper fallback strategies. For required var...
-
Handle errors gracefully always
appwrite/appwrite10⭐ 51959Always implement graceful error handling for resource lookups, data parsing, and system operations. Catch s...
-
Enforce API endpoint consistency
appwrite/appwrite10⭐ 51959When implementing or modifying API endpoints, ensure consistency across related routes by checking: 1. Par...
-
optimize algorithmic efficiency
alacritty/alacritty10⭐ 59675Eliminate unnecessary operations and choose appropriate data structures to improve algorithmic efficiency. ...
-
Consistent semantic naming
vercel/ai10⭐ 15590Use clear, consistent, and semantic naming patterns across your codebase to improve readability and maintai...
-
Prefer idiomatic Option handling
zed-industries/zed9⭐ 62119When handling null values in Rust, use idiomatic Option patterns instead of verbose nested conditionals. Th...
-
Eliminate unnecessary code patterns
microsoft/vscode9⭐ 174887Remove redundant code patterns that add complexity without value. This includes: 1. Duplicate code blocks ...
-
Extract reusable functions
volcano-sh/volcano9⭐ 4899When you identify duplicate code blocks, complex logic that can be simplified, or functionality that doesn'...
-
Avoid magic numbers
vllm-project/vllm9⭐ 51730Replace hardcoded values and magic numbers in AI model code with named constants or configuration parameter...
-
Write clear test cases
Unstructured-IO/unstructured9⭐ 12116Structure test cases for maximum readability and maintainability by following these principles: 1. Organiz...
-
validate configuration defaults
Unstructured-IO/unstructured9⭐ 12116Configuration parameters should be properly validated with appropriate defaults and clear handling of edge ...
-
Use descriptive specific names
twentyhq/twenty9⭐ 35477Names should be descriptive and specific enough to clearly communicate their purpose and avoid confusion. T...
-
Propagate errors with context
vercel/turborepo9⭐ 28115Properly propagate errors to callers with sufficient context rather than handling them prematurely or hidin...
-
Release locks before waking
tokio-rs/tokio9⭐ 28989In concurrent systems, it's critical to release locks before performing operations that might trigger reent...
-
Use consistent error handling
tensorflow/tensorflow9⭐ 190625Apply standardized error handling patterns across your codebase for improved reliability and debugging. For...
-
Use descriptive names
gravitational/teleport9⭐ 19109Choose names that clearly indicate their purpose and behavior rather than using generic or ambiguous terms....
-
thoughtful configuration design
gravitational/teleport9⭐ 19109When designing configuration schemas and fields, carefully consider their placement, validation, and long-t...
-
use modern null-safe operators
sveltejs/svelte9⭐ 83580Prefer modern JavaScript null-safe operators over verbose conditional checks to improve code readability an...
-
prefer simple code patterns
sveltejs/svelte9⭐ 83580Choose straightforward, readable code patterns over complex or clever alternatives. This improves maintaina...
-
Configurable model selection
browserbase/stagehand9⭐ 16443Avoid hard-coding model names and provider-specific configurations throughout the codebase. Instead, implem...
-
Preserve API compatibility
spring-projects/spring-boot9⭐ 77637When evolving APIs, maintain backward compatibility to avoid breaking client code. Consider these guideline...
-
avoid unwrap and panic
servo/servo9⭐ 32962Replace `.unwrap()` and `panic!()` calls with proper error handling to prevent crashes and improve robustne...
-
API design patterns
servo/servo9⭐ 32962Design APIs with appropriate parameter types, place conversion functions as trait implementations in the co...
-
consistent async/await usage
serverless/serverless9⭐ 46810When refactoring code to use async/await, ensure complete and consistent adoption throughout the function o...
-
Descriptive identifier naming
getsentry/sentry-php9⭐ 1873Choose meaningful, self-explanatory names for variables, parameters, properties, and methods that clearly c...
-
Use descriptive names
semgrep/semgrep9⭐ 12598Names should clearly and accurately describe their purpose, avoiding abbreviations, acronyms, and misleadin...
-
prefer simple readable code
semgrep/semgrep9⭐ 12598Choose clarity and simplicity over clever or complex constructs. Avoid unnecessary abstractions, complex fu...
-
avoid failwith patterns
semgrep/semgrep9⭐ 12598Avoid using `failwith`, `assert false`, and similar blunt error handling mechanisms that can turn recoverab...
-
Keep documentation purposefully minimal
rust-lang/rust9⭐ 105254Documentation should be concise, focused, and maintainable. Follow these principles: 1. Keep examples shor...
-
Specific exceptions with context
dotnet/runtime9⭐ 16578Always throw the most specific exception type appropriate for the error condition and include contextual in...
-
Optimize memory access
dotnet/runtime9⭐ 16578When implementing performance-critical algorithms, carefully consider memory access patterns. Document alig...
-
Follow naming patterns
dotnet/runtime9⭐ 16578Maintain consistent naming patterns throughout your code to improve readability and maintainability. Follow...
-
prefer Kotlin idioms
facebook/react-native9⭐ 123178Use Kotlin-specific constructs and syntax patterns instead of Java-style code to improve readability and ma...
-
Self-documenting identifier names
rails/rails9⭐ 57027Use clear, self-documenting names for variables, methods, and classes that express intent without exposing ...
-
Layer security defenses
rails/rails9⭐ 57027Implement multiple layers of security throughout your application rather than relying on a single protectio...
-
Verify token security level
quarkusio/quarkus9⭐ 14667When refreshing or updating authentication tokens, always verify the new token maintains or exceeds the ori...
-
minimize memory allocations
prometheus/prometheus9⭐ 59616Prioritize memory allocation minimization through buffer reuse, pre-allocation, and efficient data structur...
-
refactor complex conditions
prettier/prettier9⭐ 50772Break down complex inline conditions and nested logic into separate, well-named functions or simpler expres...
-
Use descriptive names
PostHog/posthog9⭐ 28460Choose names that clearly communicate purpose and accurately represent what they describe. Avoid ambiguous ...
-
Appropriate error handling
pola-rs/polars9⭐ 34296Distinguish between implementation errors (invariant violations) and expected failure cases. For implementa...
-
explicit configuration specification
python-poetry/poetry9⭐ 33496Always explicitly specify configuration values rather than relying on defaults or implicit behavior. Poetry...
-
Use semantically accurate names
commaai/openpilot9⭐ 58214Variable, method, and class names should accurately reflect their actual behavior and purpose. Misleading o...
-
Prefer explicit readable code
commaai/openpilot9⭐ 58214Write code that prioritizes readability and explicitness over cleverness or brevity. This includes several ...
-
Semantic over generic names
netty/netty9⭐ 34227Choose specific, descriptive names that clearly convey purpose over generic or abbreviated identifiers. Nam...
-
Document public APIs
netty/netty9⭐ 34227All public-facing APIs must be thoroughly documented with clear javadocs. This includes: 1. **Classes and ...
-
Explicit default configurations
nestjs/nest9⭐ 71767Always provide explicit default values for configuration options to improve code readability and maintainab...
-
Choose meaningful identifier names
nestjs/nest9⭐ 71767Names for variables, methods, and classes should be descriptive, semantically accurate, and consistent with...
-
Vue component test requirement
n8n-io/n8n9⭐ 122978Every Vue component (.vue file) that is created or modified must have at least one corresponding unit test ...
-
Use descriptive specific names
mastodon/mastodon9⭐ 48691Choose descriptive, specific names that clearly communicate intent and behavior rather than generic or ambi...
-
Ensure semantic naming accuracy
logseq/logseq9⭐ 37695Names should accurately reflect the actual behavior, purpose, and scope of functions, variables, and classe...
-
Use descriptive consistent names
LMCache/LMCache9⭐ 3800Choose names that clearly convey their purpose, role, and meaning while maintaining consistency with establ...
-
Safe access patterns
BerriAI/litellm9⭐ 28310Always use safe access methods when working with potentially null or undefined values. Use .get() for dicti...
-
AI provider documentation completeness
BerriAI/litellm9⭐ 28310Ensure comprehensive documentation for AI/ML provider integrations that covers all usage patterns, uses pre...
-
Sync documentation with code
langfuse/langfuse9⭐ 13574Always ensure documentation and comments accurately reflect the actual code implementation. When modifying ...
-
API documentation completeness
langflow-ai/langflow9⭐ 111046Ensure API documentation provides comprehensive, accurate information including limitations, complete workf...
-
Use semantically accurate names
apache/kafka9⭐ 30575Choose names that accurately reflect the purpose, scope, and semantics of variables, methods, and classes. ...
-
eliminate redundant code
jj-vcs/jj9⭐ 21171Remove unnecessary code, operations, and annotations that don't add value. This includes redundant type ann...
-
Simplify code structure
istio/istio9⭐ 37192Prioritize code simplicity and readability by leveraging standard library functions, improving control flow...
-
Add explanatory comments
istio/istio9⭐ 37192Code should include explanatory comments that help future maintainers understand complex logic, design deci...
-
Use transactions for consistency
elie222/inbox-zero9⭐ 8267Always wrap multiple related database operations in a transaction to ensure data consistency and prevent pa...
-
Remove commented code
elie222/inbox-zero9⭐ 8267Commented-out code should be removed from the codebase rather than left as comments. Keeping commented code...
-
Extract repeated code
grafana/grafana9⭐ 68825Identify and extract repeated code patterns into well-named functions to improve readability, maintainabili...
-
eliminate code duplication
block/goose9⭐ 19037Actively identify and eliminate code duplication by extracting repeated logic into reusable functions, usin...
-
Code structure clarity
ghostty-org/ghostty9⭐ 32864Write code with clear structural organization that enhances readability and maintainability. Extract duplic...
-
organize code by responsibility
google-gemini/gemini-cli9⭐ 65062Place code at the appropriate abstraction level and extract complex logic to dedicated modules. Large files...
-
Explicit null handling
laravel/framework9⭐ 33763Use explicit identity comparisons for null checks and leverage modern PHP null-handling features to create ...
-
minimize memory allocations
gofiber/fiber9⭐ 37560Prioritize reducing memory allocations and choosing efficient data structures to improve performance. Avoid...
-
Ensure comprehensive test coverage
gofiber/fiber9⭐ 37560All code paths, error conditions, and edge cases must have corresponding unit tests to ensure robust functi...
-
Documentation translation guidelines
fastapi/fastapi9⭐ 86871Maintain consistency and accuracy when translating documentation. Ensure technical terms and special format...
-
conditional feature initialization
electron/electron9⭐ 117644Only initialize configuration-dependent features, systems, or resources when the relevant settings, flags, ...
-
Name reflects meaning
elastic/elasticsearch9⭐ 73104Choose names that clearly communicate the intent, behavior, and semantics of code elements. Names should be...
-
Eliminate code duplication
duckdb/duckdb9⭐ 32061Actively identify and eliminate code duplication to improve maintainability and reduce the risk of inconsis...
-
avoid silent failures
stanfordnlp/dspy9⭐ 27813Always provide clear feedback when operations fail, even when continuing with fallbacks or alternative appr...
-
Use modern null handling
discourse/discourse9⭐ 44898Leverage modern JavaScript operators and patterns for cleaner, more robust null and undefined handling. Thi...
-
minimize memory allocations
denoland/deno9⭐ 103714Identify and eliminate unnecessary memory allocations in performance-critical code paths. This includes pre...
-
Remove debugging artifacts
deeplearning4j/deeplearning4j9⭐ 14036Production code should be free from debugging artifacts that reduce readability and maintainability. Remove...
-
Extract repeated logic
comfyanonymous/ComfyUI9⭐ 83726When you notice code patterns being repeated across functions or methods, extract the common logic into sep...
-
Use descriptive names
snyk/cli9⭐ 5178Choose names that clearly communicate purpose, content, and intent. Avoid generic or ambiguous identifiers ...
-
Fail gracefully always
chef/chef9⭐ 7860Ensure code handles errors robustly by using protective patterns that prevent resource leaks, provide clear...
-
Centralize environment variables
bridgecrewio/checkov9⭐ 7668All environment variables should be defined in a centralized location (`checkov/common/util/env_vars_config...
-
Authorization hierarchy verification
calcom/cal.com9⭐ 37732Always implement comprehensive authorization checks that verify user permissions at the appropriate hierarc...
-
Ensure comprehensive test coverage
bazelbuild/bazel9⭐ 24489When implementing new functionality or modifying existing code, always add corresponding tests that compreh...
-
Documentation quality standards
Azure/azure-sdk-for-net9⭐ 5809Ensure documentation is specific, complete, and actionable for developers: 1. **Provide meaningful content...
-
Axum Code Review: Interaction Patterns
tokio-rs/axum9⭐ 22100When implementing Axum-based applications, it is crucial to ensure that the interaction patterns between co...
-
Ensure database transactional integrity
appwrite/appwrite9⭐ 51959When performing multiple related database operations, use transactions and proper error handling to maintai...
-
comprehensive test coverage
angular/angular9⭐ 98611Ensure test suites provide comprehensive coverage by including edge cases, different input scenarios, and a...
-
Use descriptive names
cloudflare/workers-sdk8⭐ 3379Choose names that clearly describe their purpose, behavior, and data type rather than generic or ambiguous ...
-
Informative error messages
cloudflare/workers-sdk8⭐ 3379Error messages should provide specific context and actionable guidance to help developers understand and re...
-
dependency version constraints
cloudflare/workers-sdk8⭐ 3379Ensure consistent and appropriate dependency version constraints across all package.json files. Use flexibl...
-
Use appropriate exception types
cloudflare/workerd8⭐ 6989Choose the correct exception handling mechanism and type based on the error condition's nature and audience...
-
Prioritize descriptive naming
cloudflare/workerd8⭐ 6989Choose clear, self-explanatory names that prioritize readability over brevity. Avoid abbreviations, obscure...
-
isolate lock safety
cloudflare/workerd8⭐ 6989Always ensure proper isolate lock management and thread-safe access patterns when working with JavaScript c...
-
Vectorize over Python loops
vllm-project/vllm8⭐ 51730Replace Python loops and list comprehensions with vectorized operations when processing tensors or performi...
-
Catch specific exception types
vllm-project/vllm8⭐ 51730Avoid using broad exception handlers like `except Exception:` or bare `except:`. Instead, catch specific ex...
-
Prevent concurrent access races
vitessio/vitess8⭐ 19815When sharing data across goroutines, always use proper synchronization mechanisms to prevent race condition...
-
Meaningful consistent naming
vitessio/vitess8⭐ 19815Use descriptive, semantically clear names that follow consistent patterns throughout the codebase. Names sh...
-
Names should be descriptive
astral-sh/uv8⭐ 60322Use clear, descriptive names while avoiding redundant qualifiers. Choose full words over abbreviations unle...
-
Clear precise documentation
astral-sh/uv8⭐ 60322Documentation should use direct, precise language that accurately describes components and their behavior. ...
-
Use descriptive semantic names
unionlabs/union8⭐ 74800Choose names that clearly communicate purpose, intent, and functionality rather than generic or abbreviated...
-
Optimize critical loops
microsoft/typescript8⭐ 105378When implementing algorithms with nested loops or recursive operations, carefully analyze the computational...
-
simplify code structure
twentyhq/twenty8⭐ 35477Write code that is easy to read and understand by avoiding unnecessary complexity in structure and logic. T...
-
Validate configurations comprehensively
vercel/turborepo8⭐ 28115When implementing configuration systems, ensure comprehensive validation, testing, and documentation. Key r...
-
Descriptive, unambiguous identifiers
vercel/turborepo8⭐ 28115Choose names that clearly express intent and behavior while avoiding ambiguity. Identifiers should communic...
-
ensure documentation completeness
traefik/traefik8⭐ 55772Documentation should include all necessary information for users to successfully implement features. This i...
-
Write focused single-purpose tests
tokio-rs/tokio8⭐ 28981Break down large test cases into smaller, focused tests that each verify a single feature or behavior. Each...
-
Optimize algorithmic complexity
tokio-rs/tokio8⭐ 28989Always consider the time and space complexity implications of your code. Choose data structures and algorit...
-
Return results not panics
huggingface/tokenizers8⭐ 9868Libraries should never panic as this can crash applications using the library. Always return a `Result` typ...
-
Use descriptive identifiers
microsoft/terminal8⭐ 99242Choose clear, self-documenting names for variables, methods, parameters, and properties that explicitly con...
-
optimize algorithmic choices
microsoft/terminal8⭐ 99242Choose efficient algorithms and data structures to improve performance and reduce computational overhead. T...
-
Cache expensive computations
microsoft/terminal8⭐ 99242Identify and cache the results of expensive operations that are computed repeatedly with the same inputs. T...
-
Names reflect precise behavior
temporalio/temporal8⭐ 14953Choose names that accurately reflect the behavior and purpose of code elements. Names should be semanticall...
-
Descriptive specific names
spring-projects/spring-framework8⭐ 58382Choose names that are specific, descriptive, and accurately reflect the purpose and domain of variables, me...
-
Optimize test case design
spring-projects/spring-boot8⭐ 77637Write focused, efficient tests that validate core functionality without unnecessary complexity. Key princip...
-
Follow consistent style conventions
spring-projects/spring-boot8⭐ 77637Spring Boot projects maintain specific coding style conventions for consistency and readability. When contr...
-
Explicit security configurations
spring-projects/spring-boot8⭐ 77637When configuring security-related features, always use the most specific configurer classes to make securit...
-
Eliminate redundant operations
sgl-project/sglang8⭐ 17245Avoid duplicate function calls, repeated tensor operations, and redundant computations that can significant...
-
avoid unsafe unwrapping
servo/servo8⭐ 32962Replace `.unwrap()` calls and sentinel values with safe null handling patterns to prevent runtime panics an...
-
avoid unnecessary work
servo/servo8⭐ 32962Identify and eliminate computational work that serves no purpose, particularly for inactive, hidden, or irr...
-
prefer simple readable patterns
serverless/serverless8⭐ 46810Choose simple, readable code patterns over complex alternatives. Avoid unnecessary complexity that doesn't ...
-
maintain backwards compatibility
strands-agents/sdk-python8⭐ 4044When modifying public APIs, always preserve backwards compatibility to avoid breaking existing consumers. P...
-
Precise type narrowing
astral-sh/ruff8⭐ 40619Implement sound type narrowing algorithms that balance precision with correctness. When narrowing types: 1...
-
Use descriptive, conflict-free names
TanStack/router8⭐ 11590Choose descriptive names that clearly convey purpose while avoiding conflicts with existing APIs, built-in ...
-
Dependency version specification
TanStack/router8⭐ 11590Ensure proper dependency version specification and compatibility management in package.json files. Use expl...
-
Extract reusable patterns
RooCodeInc/Roo-Code8⭐ 17288Extract repetitive or complex code into reusable functions, components, or custom hooks. This improves code...
-
Organize tests for clarity
rails/rails8⭐ 57027Structure tests to maximize clarity and maintainability by: 1. Placing related tests together in appropriat...
-
Optimize numerical precision
pytorch/pytorch8⭐ 91345When implementing AI operations that involve matrix multiplication or neural network components, explicitly...
-
Use configurable default values
prowler-cloud/prowler8⭐ 11834Make configuration values flexible and robust by avoiding hardcoded values and providing sensible defaults....
-
Specific exception handling
prowler-cloud/prowler8⭐ 11834Handle exceptions with specificity rather than using broad catch-all blocks. Catch specific exception types...
-
Write meaningful documentation
prometheus/prometheus8⭐ 59616Documentation comments should be accurate, concise, and add genuine value rather than restating obvious cod...
-
metrics registration lifecycle
prometheus/prometheus8⭐ 59616Ensure proper metrics registration and lifecycle management to maintain observability system stability. Han...
-
Configuration mutual exclusivity validation
prometheus/prometheus8⭐ 59616Ensure configuration options that are mutually exclusive are properly validated with clear, actionable erro...
-
explicit null handling
prisma/prisma8⭐ 42967Prefer explicit null and undefined handling over optional or nullable types. When possible, provide default...
-
dependency classification standards
prisma/prisma8⭐ 42967Ensure proper classification and versioning of package dependencies in package.json files. Dependencies sho...
-
Use descriptive variable names
prettier/prettier8⭐ 50772Choose variable and function names that clearly communicate their purpose, type, and context. Avoid abbrevi...
-
Documentation example consistency
prettier/prettier8⭐ 50772Ensure all code examples and documentation maintain consistent formatting standards, use descriptive variab...
-
Explicit null handling
python-poetry/poetry8⭐ 33496Use explicit and clear patterns when handling null/None values to improve code readability and maintainabil...
-
API consistency standards
emcie-co/parlant8⭐ 12205Maintain consistent patterns across all API endpoints, including naming conventions, response structures, H...
-
Separate configuration lifecycles
opentofu/opentofu8⭐ 25901Maintain clear separation between different stages of configuration processing by creating dedicated struct...
-
Log effectively for debugging
opentofu/opentofu8⭐ 25901Always include meaningful log messages at appropriate levels to aid in debugging and system monitoring. Fol...
-
Document intent and limitations
opentofu/opentofu8⭐ 25901Clearly document the intended purpose, scope limitations, and design decisions in your code. For all export...
-
Follow GoDoc conventions
ollama/ollama8⭐ 145704Document code following Go's official documentation style guide (https://tip.golang.org/doc/comment). All e...
-
Descriptive balanced naming
ollama/ollama8⭐ 145704Choose identifier names that clearly communicate their purpose while maintaining an appropriate balance bet...
-
Use specific assertions
octokit/octokit.net8⭐ 2793Always write assertions that verify specific, expected values rather than simple existence or boolean check...
-
Document public API elements
octokit/octokit.net8⭐ 2793Every public API element (classes, methods, properties, constructors) must have XML documentation comments ...
-
explicit null safety
novuhq/novu8⭐ 37700Always perform explicit null and undefined checks before processing values, and use the nullish coalescing ...
-
Complete OpenAPI annotations
novuhq/novu8⭐ 37700Ensure all API endpoints have complete and accurate OpenAPI annotations to support proper SDK generation an...
-
Informative error messages
nodejs/node8⭐ 112178Error messages should be specific, actionable, and include context that helps developers understand and fix...
-
Evolve return values
nodejs/node8⭐ 112178When extending APIs with new capabilities, carefully consider how changes to return values affect consumers...
-
Technical documentation precision
vercel/next.js8⭐ 133000Ensure technical documentation is precise, accurate, and correctly formatted to prevent confusion and impro...
-
Secure Data Handling in Next.js Applications
vercel/next.js8⭐ 133000When building Next.js applications that handle sensitive data, it's crucial to implement robust security me...
-
Effective Cache Management in Next.js Applications
vercel/next.js8⭐ 133000When implementing caching in Next.js applications, it is crucial to be intentional about the caching behavi...
-
reduce test verbosity
neovim/neovim8⭐ 91433Write concise, efficient tests by eliminating repetitive code and combining related test cases. Avoid verbo...
-
consistent naming conventions
neovim/neovim8⭐ 91433Maintain consistent naming patterns and terminology across the codebase to reduce cognitive load and improv...
-
Design domain-specific error types
neondatabase/neon8⭐ 19015Create and use domain-specific error types instead of generic errors or anyhow. This improves error handlin...
-
Use structured logging
n8n-io/n8n8⭐ 122978Always use the project's structured logger instead of direct console methods (`console.log`, `console.error...
-
Prevent null reference exceptions
n8n-io/n8n8⭐ 122978Always use optional chaining and nullish coalescing operators to prevent runtime errors when accessing prop...
-
Technical precision matters
apache/mxnet8⭐ 20801When documenting AI models, frameworks, and optimization techniques, precision in language is as important ...
-
Validate noexcept guarantees
maplibre/maplibre-native8⭐ 1411Only mark functions as `noexcept` when you can guarantee they won't throw exceptions under any circumstance...
-
Environment variable access
lobehub/lobe-chat8⭐ 65138Use direct `process.env` access and standardized configuration management instead of custom environment var...
-
Use descriptive names
llvm/llvm-project8⭐ 33702Choose names that clearly describe the purpose, behavior, and content of functions, variables, and constant...
-
maintain naming consistency
ggml-org/llama.cpp8⭐ 83559Follow established naming patterns and conventions consistently throughout the codebase. This includes usin...
-
Extract repeated code
langfuse/langfuse8⭐ 13574Follow the DRY (Don't Repeat Yourself) principle by extracting repeated code patterns into helper functions...
-
API field documentation
kubernetes/kubernetes8⭐ 116489API fields must be comprehensively documented with clear behavior specifications, format constraints, and i...
-
Effective API samples
JetBrains/kotlin8⭐ 50857Create clear, comprehensive, and properly structured code samples to document API usage. Follow these princ...
-
Conditional configuration management
kilo-org/kilocode8⭐ 7302Ensure configurations are conditional, context-aware, and resilient. Use feature flags to control functiona...
-
prefer modern collection APIs
apache/kafka8⭐ 30575Use modern collection creation methods instead of legacy alternatives for improved readability and concisen...
-
Use descriptive names
influxdata/influxdb8⭐ 30268Names in code should be self-documenting, accurately reflect purpose, and follow consistent conventions. Ap...
-
Promote code clarity
influxdata/influxdb8⭐ 30268Write code that prioritizes clarity and maintainability over brevity. This involves several key practices: ...
-
Minimize critical path allocations
influxdata/influxdb8⭐ 30268Avoid unnecessary memory allocations in performance-critical code paths. These allocations not only consume...
-
Lock with defer unlock
influxdata/influxdb8⭐ 30268Always follow the lock-defer-unlock pattern when protecting shared resources with mutexes. Acquire the lock...
-
Choose appropriate lock primitives
influxdata/influxdb8⭐ 30268Select lock types based on access patterns - prefer RWLock over Mutex for read-heavy operations to enable c...
-
Maintain clean code structure
hyprwm/Hyprland8⭐ 28863Keep code well-organized by separating interface from implementation, managing dependencies properly, and f...
-
Protect sensitive data
juspay/hyperswitch8⭐ 34028Wrap all sensitive data fields in Secret<> types to prevent accidental exposure through logs, debug output,...
-
Documentation clarity and formatting
ghostty-org/ghostty8⭐ 32864Ensure documentation is clear, precise, and consistently formatted. Key practices include: 1. **Be explici...
-
Prevent concurrent state races
google-gemini/gemini-cli8⭐ 65062When multiple operations can execute concurrently (e.g., multiple keystrokes in the same React event loop, ...
-
Use semantic exceptions
laravel/framework8⭐ 33763Choose exception types that accurately reflect the nature of the error. Use `LogicException` for developer ...
-
Precise type annotations
laravel/framework8⭐ 33763Always use the most specific and accurate type information possible in PHPDoc comments to improve static an...
-
Follow naming patterns
gofiber/fiber8⭐ 37560Maintain consistent naming conventions throughout the codebase by following established patterns and avoidi...
-
Write clear documentation
fastify/fastify8⭐ 34000Documentation should be clear, precise, and self-contained while following established style conventions. W...
-
Isolate configuration concerns
fastapi/fastapi8⭐ 86871Keep configuration settings separate from application code by using environment variables or dedicated conf...
-
Document all responses
fastapi/fastapi8⭐ 86871When designing APIs, thoroughly document all possible responses your endpoints can return, not just the "ha...
-
Single source documentation
expressjs/express8⭐ 67300Maintain documentation with a single source of truth to prevent inconsistencies and reduce maintenance burd...
-
Enforce null safety patterns
expressjs/express8⭐ 67300Implement comprehensive null safety patterns to prevent runtime errors and ensure predictable behavior. Fol...
-
use optional types safely
electron/electron8⭐ 117644When functions may not return valid values, use `std::optional` or `absl::optional` instead of raw types th...
-
Optimize before implementing
elastic/elasticsearch8⭐ 73104Before implementing algorithms, evaluate their efficiency implications, especially for operations that may ...
-
Handle optional dependencies gracefully
stanfordnlp/dspy8⭐ 27813When integrating with external AI libraries, models, or services, handle optional dependencies gracefully t...
-
verify authorization explicitly
discourse/discourse8⭐ 44898Always perform explicit authorization checks rather than assuming existing security controls are sufficient...
-
Avoid ambiguous naming
denoland/deno8⭐ 103714Choose names that clearly convey their purpose and avoid ambiguous identifiers that can be misinterpreted. ...
-
Document API completely
deeplearning4j/deeplearning4j8⭐ 14036All public APIs must have comprehensive and clear documentation that helps developers understand functional...
-
Semantic naming patterns
crewaiinc/crewai8⭐ 33945Names should clearly communicate purpose, relationships, and domain context. Choose identifiers that reveal...
-
Prefer pythonic simplicity
crewaiinc/crewai8⭐ 33945Use Python's expressive features to write cleaner, more maintainable code by reducing nesting and improving...
-
Clear variable naming
home-assistant/core8⭐ 80450Use descriptive, unambiguous variable and function names that clearly convey their purpose and avoid confli...
-
avoid code duplication
home-assistant/core8⭐ 80450Create reusable components instead of duplicating similar code patterns. When you find yourself writing sim...
-
Environment variable validation
docker/compose8⭐ 35858Always validate environment variables and provide appropriate fallbacks when using them for configuration. ...
-
break down large files
cline/cline8⭐ 48299Large files with multiple responsibilities should be broken down into focused, single-responsibility module...
-
validate before executing operations
ClickHouse/ClickHouse8⭐ 42425Always validate inputs and preconditions before executing database operations, and fail explicitly rather t...
-
Use centralized loggers
snyk/cli8⭐ 5178Always use centrally supplied loggers from the invocation context or configuration instead of creating new ...
-
Extract and organize methods
chef/chef8⭐ 7860Break down large, complex methods into smaller, focused methods with clear names that describe their purpos...
-
Write pythonic code
bridgecrewio/checkov8⭐ 7668Embrace Python's idiomatic programming style to make your code more readable, concise, and maintainable. Fo...
-
Safe dictionary access
bridgecrewio/checkov8⭐ 7667Always use safe dictionary access patterns when handling potentially null or missing values. This prevents ...
-
Restrict public network
bridgecrewio/checkov8⭐ 7668Always configure cloud resources to restrict or disable public network access unless explicitly required fo...
-
Choose optimal algorithms
bridgecrewio/checkov8⭐ 7667Always select appropriate data structures and algorithms based on their performance characteristics and the...
-
Write self-documenting tests
boto/boto38⭐ 9417Tests should clearly communicate their purpose and expectations without requiring readers to analyze implem...
-
Wrap errors with context
argoproj/argo-cd8⭐ 20149When propagating errors up the call stack, always wrap them with contextual information about the failing o...
-
Comprehensive migration planning
appwrite/appwrite8⭐ 51959When changing identifier systems (e.g., from using `getInternalId()` to `getSequence()`), implement compreh...
-
consistent null handling patterns
angular/angular8⭐ 98611Use consistent and meaningful null/undefined handling patterns throughout your code. Prefer positive type g...
-
Explain code intent
alacritty/alacritty8⭐ 59675Comments and documentation should explain WHY code exists and what purpose it serves, not just describe wha...
-
Use descriptive action names
apache/airflow8⭐ 40858Names should clearly indicate purpose and behavior using appropriate action verbs and descriptive terms. Th...
-
Test through public APIs
zed-industries/zed7⭐ 62119Write comprehensive tests that validate functionality through public interfaces rather than testing impleme...
-
Document compatibility flags comprehensively
cloudflare/workerd7⭐ 6989All compatibility flags must include comprehensive documentation that clearly explains their purpose, behav...
-
comprehensive assertion testing
cloudflare/workerd7⭐ 6989Ensure test assertions are thorough and complete by testing both expected behavior and error conditions wit...
-
Avoid redundant operations
volcano-sh/volcano7⭐ 4899Eliminate duplicate computations, unnecessary API calls, and redundant processing to improve performance an...
-
Add explicit nil checks
volcano-sh/volcano7⭐ 4899Always add explicit nil checks before accessing object properties and after type assertions to prevent null...
-
Follow logging best practices
vllm-project/vllm7⭐ 51730Maintain high-quality logging throughout the codebase by following these best practices: 1. **Use appropri...
-
Check before access
vllm-project/vllm7⭐ 51730Always verify that objects, attributes, and variables are not None before accessing their properties, calli...
-
Dynamic configuration needs validation
vitessio/vitess7⭐ 19815When implementing dynamic configuration options, validate that the system actually supports runtime changes...
-
Descriptive consistent naming
vitejs/vite7⭐ 74031Choose variable, function, and class names that accurately reflect their purpose while maintaining consiste...
-
informative error messages
vlang/v7⭐ 36582Error messages should be specific, contextual, and include relevant information to aid debugging and user u...
-
function documentation standards
vlang/v7⭐ 36582All public functions and methods must be documented with comments that `v doc` can understand. Documentatio...
-
Clear technical writing
vlang/v7⭐ 36582Ensure technical documentation uses clear, grammatically correct language with consistent formatting when e...
-
Choose efficient data structures
vlang/v7⭐ 36582Select data structures and algorithms based on performance characteristics and actual usage patterns rather...
-
Structure for readability
astral-sh/uv7⭐ 60322Organize code to maximize readability and maintainability. When code becomes complex, break it down into sm...
-
Redact URL credentials
astral-sh/uv7⭐ 60322Always redact sensitive credentials in URLs before logging, displaying in error messages, or serializing to...
-
Choose efficient data structures
unionlabs/union7⭐ 74800Select data structures and algorithms that optimize for the specific use case rather than defaulting to gen...
-
Organize tailwind classes
shadcn-ui/ui7⭐ 90568Structure your Tailwind CSS classes for readability and maintainability. Instead of long chains of conditio...
-
Names reveal semantic purpose
microsoft/typescript7⭐ 105378Choose names that clearly communicate the semantic purpose and behavior of code elements. Variable and func...
-
Document function behavior completely
microsoft/typescript7⭐ 105378Functions should be documented with comprehensive JSDoc comments that cover: 1. Purpose and behavior descri...
-
prefer compile-time configuration
tree-sitter/tree-sitter7⭐ 21799Use compile-time configuration checks with `cfg!` macros instead of runtime environment variable parsing wh...
-
avoid unnecessary Option operations
tree-sitter/tree-sitter7⭐ 21799When working with Option types, prefer efficient and safe access patterns over unnecessary operations. Use ...
-
Use descriptive names
traefik/traefik7⭐ 55772Choose names that clearly express the purpose, behavior, or semantic meaning of variables, functions, and t...
-
Structure conditional compilation
tokio-rs/tokio7⭐ 28981Use organized structural patterns for conditional compilation to improve code maintainability and readabili...
-
Follow naming conventions
tokio-rs/tokio7⭐ 28981Choose names that follow established API conventions and guidelines to create a consistent, intuitive codeb...
-
Meaningful consistent names
tensorflow/tensorflow7⭐ 190625Choose names that are both semantically precise and follow consistent conventions. Names should accurately ...
-
Measure performance impact
sveltejs/svelte7⭐ 83580Before making performance-related changes, measure the actual impact with benchmarks and profiling. Many pe...
-
Document structure consistency
supabase/supabase7⭐ 86070Maintain consistent document structure and formatting in documentation to improve readability and user expe...
-
Use AssertJ correctly
spring-projects/spring-framework7⭐ 58382Spring Framework tests must use AssertJ for assertions rather than JUnit's `Assertions`, Spring's `Assert` ...
-
Maintain consistent naming patterns
spring-projects/spring-boot7⭐ 77637Follow established naming patterns and conventions throughout the codebase to ensure consistency and clarit...
-
Consistent observability data
spring-projects/spring-boot7⭐ 77637When implementing observability features, always ensure consistency in your data model, especially with tag...
-
Simplify conditional structures
apache/spark7⭐ 41554Organize complex conditional logic using clear, sequential patterns rather than nested structures or multip...
-
validate memory bounds
bytedance/sonic7⭐ 8532Always validate array and string bounds before accessing memory to prevent out-of-bounds access and potenti...
-
Package organization standards
SigNoz/signoz7⭐ 23369Maintain proper package organization by following established structural patterns and separation of concern...
-
Promise error handling patterns
serverless/serverless7⭐ 46810When handling promise errors, use the second callback parameter of `.then()` instead of `.catch()` when you...
-
Eliminate redundant operations
serverless/serverless7⭐ 46810Identify and eliminate repeated expensive operations to improve performance. Look for opportunities to cach...
-
API schema validation accuracy
serverless/serverless7⭐ 46810Ensure that JSON schema validation for API configurations precisely matches the actual service requirements...
-
Language-agnostic configuration design
oraios/serena7⭐ 14465Design configuration parameters to be language-agnostic when possible, use established configuration object...
-
Use data providers effectively
getsentry/sentry-php7⭐ 1873Organize your test suite by using data providers to consolidate similar test cases rather than creating mul...
-
Evolve API safely
getsentry/sentry-php7⭐ 1873When modifying existing APIs, implement changes that maintain backward compatibility while enabling new fun...
-
Minimize mocks verify behavior
getsentry/sentry7⭐ 41297Write tests that verify actual system behavior rather than implementation details by minimizing mock usage ...
-
eliminate code duplication
strands-agents/sdk-python7⭐ 4044Identify and consolidate duplicate code patterns by extracting common logic into reusable functions and uni...
-
Choose appropriate synchronization
strands-agents/sdk-python7⭐ 4044Select the correct synchronization mechanism based on your execution context and avoid unnecessary synchron...
-
Standardize configuration value handling
rust-lang/rust7⭐ 105254Implement robust and type-safe configuration handling to avoid fragile hardcoding and improve maintainabili...
-
Ensure complete test coverage
rust-lang/rust7⭐ 105254Write comprehensive tests that cover all relevant cases and variations while maintaining proper organizatio...
-
Simplify code expressions
dotnet/runtime7⭐ 16578Strive for clarity by simplifying code expressions and reducing unnecessary complexity. Complex or verbose ...
-
Choose error strategies deliberately
astral-sh/ruff7⭐ 40619Make deliberate choices about error handling strategies based on the context. Decide between early returns ...
-
SSR documentation completeness
TanStack/router7⭐ 11590Ensure server-side rendering documentation provides complete implementation details with proper build confi...
-
Validate nullable values explicitly
RooCodeInc/Roo-Code7⭐ 17288Always handle potentially null or undefined values explicitly using type guards, null coalescing operators,...
-
Preserve error context chain
RooCodeInc/Roo-Code7⭐ 17288When catching and re-throwing errors, always preserve the original error context using the `cause` option o...
-
Maintain consistent terminology patterns
RooCodeInc/Roo-Code7⭐ 17288Ensure consistent terminology usage across the codebase, especially in localization files and technical doc...
-
Document i18n string usage
RooCodeInc/Roo-Code7⭐ 17288All user-facing strings must be documented with translation function usage to ensure proper internationaliz...
-
Consistent localization formatting
RooCodeInc/Roo-Code7⭐ 17288Ensure all localization strings maintain consistent formatting patterns within each locale file. This inclu...
-
Configure with care
RooCodeInc/Roo-Code7⭐ 17288Always validate configuration values before use, provide sensible defaults, and centralize constants in sha...
-
simplify redundant logic
facebook/react-native7⭐ 123178Eliminate redundant conditional logic, extract duplicated code, and choose simpler patterns over complex im...
-
extract complex logic
facebook/react-native7⭐ 123178Break down complex functions and large files into smaller, focused units with clear responsibilities. Extra...
-
Configuration validation and defaults
facebook/react-native7⭐ 123178Always validate configuration structure before accessing properties and provide sensible defaults while pre...
-
avoid !! operator
facebook/react-native7⭐ 123178Avoid using the not-null assertion operator (`!!`) as it can cause runtime crashes if the assumption about ...
-
Database-specific query optimization
rails/rails7⭐ 57027Leverage database-specific features to optimize queries and improve performance. Different database engines...
-
Configure at proper scope
rails/rails7⭐ 57027Place configuration options at their proper scope within the framework hierarchy. Avoid tight coupling betw...
-
Meaningful error communication
quarkusio/quarkus7⭐ 14667Error handling should be designed to provide clear, actionable information to developers while avoiding red...
-
Document configuration comprehensively
quarkusio/quarkus7⭐ 14667Configuration properties should be thoroughly documented with explicit details about constraints, units, de...
-
API evolution strategy
quarkusio/quarkus7⭐ 14667Design APIs with future extensibility in mind by using parameter objects instead of direct method parameter...
-
Document code rationale
pydantic/pydantic7⭐ 24377Add clear comments that explain the "why" behind non-obvious code decisions, complex logic, or special-case...
-
Consistent term capitalization
pydantic/pydantic7⭐ 24377Follow consistent capitalization rules for technical terms, acronyms, and library names throughout your cod...
-
Meaningful consistent naming
prowler-cloud/prowler7⭐ 11834Use names that clearly describe the purpose and behavior of variables, methods, classes, and files, while m...
-
Extract duplicate code
prisma/prisma7⭐ 42967When you notice code patterns being repeated across multiple locations, extract them into reusable function...
-
Database provider compatibility
prisma/prisma7⭐ 42967Ensure database code properly handles provider-specific differences and capabilities. Different database pr...
-
consistent error object usage
prisma/prisma7⭐ 42967Always use proper Error objects when throwing exceptions, maintain consistent error handling contracts, and...
-
Consistent clear naming
prisma/prisma7⭐ 42967Use consistent terminology across similar concepts and choose names that clearly indicate their purpose. Av...
-
Use descriptive names
python-poetry/poetry7⭐ 33496Variable, method, and class names should clearly and accurately describe their purpose, content, or behavio...
-
optimize algorithmic efficiency
python-poetry/poetry7⭐ 33496Choose efficient algorithms and data structures to avoid unnecessary computational complexity. Look for opp...
-
dependency constraint consistency
python-poetry/poetry7⭐ 33496Maintain consistent formatting and rationale for dependency version constraints in configuration files. Use...
-
validate inputs early
microsoft/playwright7⭐ 76113Always validate function parameters and configuration options at the beginning of functions, providing spec...
-
Specify configuration behaviors
opentofu/opentofu7⭐ 25901When implementing configuration features (variables, flags, resources), thoroughly document their behavior ...
-
Optimize code location scope
open-telemetry/opentelemetry-python7⭐ 2061Place code in the most specific and appropriate location to improve findability and maintainability. Follow...
-
Future-proof API design
open-telemetry/opentelemetry-python7⭐ 2061Design APIs that can evolve without breaking existing code. Use keyword-only arguments (with `*,`) for opti...
-
Use proper assertions
opencv/opencv7⭐ 82865Write tests with proper assertions to ensure reliability and maintainability. Follow these guidelines: 1. ...
-
Use optimized functions
opencv/opencv7⭐ 82865When implementing algorithms, prefer using OpenCV's built-in optimized functions over writing custom implem...
-
Maintain consistent style
octokit/octokit.net7⭐ 2793Follow established patterns consistently throughout the codebase to improve readability and maintainability...
-
User-centric documentation practices
nrwl/nx7⭐ 27518Documentation should prioritize user needs and experience over technical convenience. This means using appr...
-
Avoid code duplication
nrwl/nx7⭐ 27518Before implementing new functionality, check if similar utilities or patterns already exist in the codebase...
-
Use consistent terminology
nuxt/nuxt7⭐ 57769Prioritize consistent, clear, and beginner-friendly terminology throughout your codebase and documentation....
-
Version APIs with care
nodejs/node7⭐ 112178When introducing new API features or changes, implement proper versioning to maintain stability and backwar...
-
Public over internal APIs
nodejs/node7⭐ 112178When designing or implementing APIs, always prefer publicly documented APIs over internal ones. Internal AP...
-
Benchmark before optimizing code
nodejs/node7⭐ 112178Performance optimizations should be validated through benchmarks before implementation. This helps prevent ...
-
Simplify control flow
netty/netty7⭐ 34227Streamline code by simplifying control flow structures to improve readability. Eliminate unnecessary nestin...
-
Proper asynchronous error handling
nestjs/nest7⭐ 71767Ensure errors in asynchronous operations and event-based systems are handled consistently to prevent unexpe...
-
Descriptive identifier names
nestjs/nest7⭐ 71766Choose identifier names (variables, functions, parameters, classes) that clearly describe their purpose, co...
-
Complete function documentation
neovim/neovim7⭐ 91433Ensure all functions have comprehensive, accurate documentation including required tags (@param, @return, @...
-
API consistency patterns
neovim/neovim7⭐ 91433Ensure similar API functions use consistent parameter patterns, types, and behaviors. When designing new AP...
-
Structure endpoints for REST
neondatabase/neon7⭐ 19015Organize API endpoints hierarchically by resource type and use appropriate HTTP methods based on operation ...
-
Clear consistent identifier names
neondatabase/neon7⭐ 19015Choose clear, consistent, and non-redundant names for identifiers across the codebase. Follow these guideli...
-
Maintain test state isolation
n8n-io/n8n7⭐ 122978Ensure each test runs in isolation by properly managing test state, mocks, and timers. Clean up all test ar...
-
Simplify for readability
apache/mxnet7⭐ 20801Complex expressions, especially nested ternary operations, reduce code readability and maintainability. Pre...
-
Consistent naming patterns
apache/mxnet7⭐ 20801Maintain consistent naming conventions throughout the codebase to enhance readability and reduce confusion....
-
remove unnecessary code
rocicorp/mono7⭐ 2091Eliminate unnecessary code elements that add complexity without providing value. This includes removing red...
-
prioritize code readability
rocicorp/mono7⭐ 2091Write code that prioritizes clarity and readability over cleverness or brevity. This includes several key p...
-
centralize configuration management
mastodon/mastodon7⭐ 48691Migrate configuration from direct environment variable access to Rails' config_for mechanism for better org...
-
Modern C++ style practices
maplibre/maplibre-native7⭐ 1411Apply modern C++ features and consistent syntax patterns to improve code readability and safety. Follow the...
-
Simplify code readability
logseq/logseq7⭐ 37695Write code that prioritizes clarity and simplicity over cleverness. Use appropriate Clojure idioms to make ...
-
Extract reusable components
lobehub/lobe-chat7⭐ 65138Extract utilities, types, constants, and shared logic into dedicated modules to improve code maintainabilit...
-
Add unit tests
lobehub/lobe-chat7⭐ 65138All new functionality must include corresponding unit tests. This is especially critical for utility functi...
-
Simplify for readability
LMCache/LMCache7⭐ 3800Improve code readability by simplifying complex logic, using Pythonic idioms, and removing unnecessary code...
-
Ensure operation completion safety
LMCache/LMCache7⭐ 3800In concurrent code, ensure that operations complete safely before proceeding to prevent race conditions and...
-
comprehensive test coverage
llvm/llvm-project7⭐ 33702Tests should comprehensively cover all relevant scenarios, including return values, edge cases, different c...
-
avoid unnecessary allocations
llvm/llvm-project7⭐ 33702Minimize performance overhead by avoiding unnecessary memory allocations, expensive data structures, and re...
-
leverage existing framework functionality
ggml-org/llama.cpp7⭐ 83559Before implementing custom solutions in AI model conversion code, thoroughly investigate whether the framew...
-
eliminate code duplication
ggml-org/llama.cpp7⭐ 83559Avoid duplicating code blocks by extracting common functionality into reusable functions, using templates f...
-
Follow consistent naming patterns
BerriAI/litellm7⭐ 28310Maintain consistent naming conventions across all aspects of the codebase, including file structures, folde...
-
Surface errors to users
langfuse/langfuse7⭐ 13574Always provide user-visible feedback for errors instead of only logging to the console. This ensures users ...
-
Falsy vs null checks
langfuse/langfuse7⭐ 13574Distinguish between falsy values (0, '', false, null, undefined) and null/undefined values in your code. Us...
-
Cache expensive operations
langfuse/langfuse7⭐ 13574Identify and cache results of computationally expensive or repetitive operations instead of recalculating t...
-
Use comprehensive JSDoc
langchain-ai/langchainjs7⭐ 15004Always use JSDoc format (`/** */`) instead of regular comments (`//`) for documenting classes, functions, a...
-
Preserve API backward compatibility
langchain-ai/langchainjs7⭐ 15004When modifying existing APIs, maintain backward compatibility by implementing changes in a non-breaking way...
-
implement proper observability
kubernetes/kubernetes7⭐ 116489Ensure observability mechanisms (events and metrics) are implemented correctly with appropriate types, accu...
-
Clear field documentation
kubernetes/kubernetes7⭐ 116489Write precise, unambiguous documentation that explains what fields and methods represent rather than implem...
-
Avoid unnecessary work
kubernetes/kubernetes7⭐ 116489Optimize performance by avoiding unnecessary computations, allocations, and operations. Use feature gates, ...
-
Simplify code structure
kubeflow/kubeflow7⭐ 15064Strive to simplify code structure by eliminating unnecessary complexity. This includes: 1. **Move conditio...
-
Precise workflow triggers
kubeflow/kubeflow7⭐ 15064Configure CI/CD workflows to trigger precisely based on relevant file path changes. This minimizes unnecess...
-
Go export naming conventions
kubeflow/kubeflow7⭐ 15064In Go, the first letter of an identifier (function, variable, struct field, etc.) determines its visibility...
-
Use configuration property providers
JetBrains/kotlin7⭐ 50857Always use Gradle's Provider API when accessing project, system, or Gradle properties in your build configu...
-
Test edge cases
JetBrains/kotlin7⭐ 50857Ensure tests verify both basic functionality and edge cases. Tests that only cover the happy path can miss ...
-
Minimize unnecessary work
JetBrains/kotlin7⭐ 50857Optimize performance by reducing the amount of computation performed, especially on data that won't appear ...
-
Keep code clearly organized
JetBrains/kotlin7⭐ 50857Maintain code readability and organization by extracting focused, well-named functions and using appropriat...
-
Design extensible stable APIs
JetBrains/kotlin7⭐ 50857When designing public APIs, prioritize extensibility while maintaining backward compatibility and implement...
-
prioritize documentation clarity
jj-vcs/jj7⭐ 21171Write documentation that prioritizes user understanding over technical precision. Avoid unclear phrases, ov...
-
Use testify assertions
influxdata/influxdb7⭐ 30268Always use the testify package (require/assert) in tests instead of standard Go testing assertions. The tes...
-
Validate environment variables strictly
elie222/inbox-zero7⭐ 8267Enforce strict validation of environment variables using Zod schemas with explicit environment-specific rul...
-
prevent null dereferences
hyprwm/Hyprland7⭐ 28863Always verify pointers are valid before dereferencing to prevent crashes and undefined behavior. This appli...
-
avoid expensive hot paths
hyprwm/Hyprland7⭐ 28863Identify and optimize expensive operations in frequently executed code paths to prevent performance bottlen...
-
API type consistency
juspay/hyperswitch7⭐ 34028Use structured types instead of generic strings in API definitions to improve type safety and clarity. Pref...
-
use descriptive names
helix-editor/helix7⭐ 39026Choose specific, purpose-revealing names that clearly communicate intent rather than generic, abbreviated, ...
-
Safe concurrent programming
grafana/grafana7⭐ 68825When working with concurrent code, carefully manage shared resources and synchronization to prevent race co...
-
Follow documentation conventions
grafana/grafana7⭐ 68825Ensure documentation adheres to established style guidelines and technical standards: 1. **Use proper term...
-
Test behavioral differences
google-gemini/gemini-cli7⭐ 65062Tests should verify that different states, modes, or inputs produce meaningfully different behaviors, not j...
-
reduce nesting complexity
google-gemini/gemini-cli7⭐ 65062Prefer early returns, guard clauses, and helper method extraction to reduce nesting levels and improve code...
-
Use modern PHPUnit attributes
laravel/framework7⭐ 33763Prefer modern PHPUnit attributes over PHPDoc annotations for improved type safety, IDE support, and code re...
-
check all error returns
gofiber/fiber7⭐ 37560Always check and handle error returns from function calls, even for operations that seem unlikely to fail. ...
-
Technical term consistency
fastapi/fastapi7⭐ 86871When working with multilingual codebases or documentation, maintain consistent naming conventions for techn...
-
Sync versus async tests
fastapi/fastapi7⭐ 86871Choose the appropriate testing approach based on your test requirements. For standard API endpoint testing,...
-
Standardize dependency version notation
expressjs/express7⭐ 67300When specifying dependencies in package.json, follow consistent version notation patterns that align with y...
-
Follow StandardJS when modifying
expressjs/express7⭐ 67300When modifying existing code, update the touched lines to follow StandardJS conventions while preserving th...
-
Clear intention in names
expressjs/express7⭐ 67300Choose names that clearly communicate intention and follow established conventions. This applies to variabl...
-
prefer const correctness
electron/electron7⭐ 117644Always mark variables, parameters, and methods as `const` when they don't modify state. This improves code ...
-
comprehensive test coverage
duckdb/duckdb7⭐ 32061Ensure thorough test coverage by systematically testing edge cases, boundary conditions, failure scenarios,...
-
avoid repeated expensive operations
duckdb/duckdb7⭐ 32061Identify and eliminate repeated expensive computations, especially in loops and frequently executed code pa...
-
Complete parameter documentation
stanfordnlp/dspy7⭐ 27813Ensure all public functions and classes have comprehensive docstrings that include parameter descriptions, ...
-
Use descriptive identifier names
django/django7⭐ 84182Choose clear, descriptive names for variables, functions, and classes that accurately convey their purpose ...
-
Follow established naming conventions
discourse/discourse7⭐ 44898Ensure all identifiers follow the established naming conventions for the codebase and framework being used....
-
Clean code formatting rules
continuedev/continue7⭐ 27819Maintain consistent and clean code formatting to improve readability and maintainability. Follow these guid...
-
CI script reliability practices
continuedev/continue7⭐ 27819Ensure CI/CD workflows maintain reliability by following these practices: 1. **Use explicit script paths**...
-
explicit configuration management
docker/compose7⭐ 35858Make all configuration settings explicit and well-documented, avoiding implicit defaults and auto-detection...
-
semantic naming accuracy
ClickHouse/ClickHouse7⭐ 42425Ensure that method, variable, and class names accurately reflect their actual behavior, purpose, or content...
-
Explicit error handling
ClickHouse/ClickHouse7⭐ 42425Always handle error conditions explicitly rather than silently ignoring them or using generic error respons...
-
Document non-obvious code
ClickHouse/ClickHouse7⭐ 42425Add explanatory comments for any code element that is not self-explanatory, including complex return types,...
-
prevent silent test failures
snyk/cli7⭐ 5178Tests must explicitly fail when expected conditions are not met, rather than silently exiting early or usin...
-
Handle all errors explicitly
snyk/cli7⭐ 5178Always explicitly handle errors rather than assuming they are handled by dependencies or ignoring them. Eve...
-
Document intent and reasoning
snyk/cli7⭐ 5178Add comments that explain the reasoning, intent, or context behind code decisions, especially for non-obvio...
-
API response consistency
snyk/cli7⭐ 5178Ensure consistent patterns for API response handling, error management, and type safety across all API inte...
-
Document with examples
chef/chef7⭐ 7860Always include comprehensive documentation with clear examples for properties, methods, and code patterns. ...
-
Consistent descriptive naming patterns
chef/chef7⭐ 7860Use clear, descriptive names that follow consistent patterns across the codebase. For methods and propertie...
-
Meaningful identifier names
bridgecrewio/checkov7⭐ 7667Choose descriptive and semantic identifiers that clearly convey purpose, role, and behavior. Avoid vague, g...
-
Validate nullability explicitly
oven-sh/bun7⭐ 79093Always validate null or undefined values before using them to prevent crashes and undefined behavior. When ...
-
Assert before cast
oven-sh/bun7⭐ 79093Always validate values before performing unsafe operations like dynamic casting. When a value could be null...
-
Standardize API integration patterns
Homebrew/brew7⭐ 44168Establish consistent patterns for API integrations by following these guidelines: 1. Document API endpoint...
-
Optimize collection operations
Homebrew/brew7⭐ 44168Use Ruby's built-in collection methods to write more efficient and readable code. This reduces algorithmic ...
-
Prevent algorithmic pitfalls
boto/boto37⭐ 9417Avoid common algorithmic errors that lead to incorrect results or inefficient code by following these pract...
-
Follow naming conventions
boto/boto37⭐ 9417Use consistent and appropriate naming conventions based on the context in Python code: 1. **Classes**: Use...
-
Defensive null value handling
boto/boto37⭐ 9417Always handle potential null/None values defensively by: 1. Using `.get()` for dictionary access instead of...
-
prefer simple readable code
bazelbuild/bazel7⭐ 24489Favor simple, readable implementations over complex or overly abstracted solutions. This includes eliminati...
-
prefer simple API designs
bazelbuild/bazel7⭐ 24489Design APIs with simple, direct interfaces rather than complex parameter passing patterns or unnecessary in...
-
optimize algorithm choices
bazelbuild/bazel7⭐ 24489Choose algorithms and data structures that provide both deterministic behavior and optimal performance char...
-
Executor service lifecycle
bazelbuild/bazel7⭐ 24489Properly manage executor service lifecycle to prevent resource leaks, deadlocks, and orphaned threads that ...
-
Configuration clarity standards
bazelbuild/bazel7⭐ 24489Configuration options should be designed with clarity, consistency, and user experience as primary concerns...
-
Design stable APIs
Azure/azure-sdk-for-net7⭐ 5809When creating or modifying APIs, carefully consider what becomes part of your public API surface to ensure ...
-
Check before dereferencing
Azure/azure-sdk-for-net7⭐ 5809Always verify objects are not null before dereferencing them, particularly when using methods that might re...
-
Defensive null checking
aws/aws-sdk-js7⭐ 7628Always perform explicit null/undefined checks before accessing properties or using values that could be nul...
-
Stable dependency version management
appwrite/appwrite7⭐ 51959Always use stable, well-defined version constraints in configuration files to ensure reproducible builds an...
-
Keep documentation paths current
appwrite/appwrite7⭐ 51959Maintain accurate and consistent documentation paths, references, and descriptions across the codebase. Whe...
-
Consistent placeholder conventions
appwrite/appwrite7⭐ 51959Ensure all placeholders in localization files follow consistent naming conventions to prevent runtime error...
-
Use semantic descriptive names
ant-design/ant-design7⭐ 95882Choose variable, function, and type names that clearly communicate their purpose, source, and context. Name...
-
Prevent component re-mounting
ant-design/ant-design7⭐ 95882Maintain stable component structure to prevent unnecessary re-mounting and unmounting of child components. ...
-
API evolution strategy
ant-design/ant-design7⭐ 95882When evolving APIs, design for extensibility and provide clear migration paths to maintain backward compati...
-
Use descriptive names
angular/angular7⭐ 98611Choose names that clearly and unambiguously describe their purpose rather than being overly generic or tech...
-
Document configuration specifics
alacritty/alacritty7⭐ 59675When documenting configuration options in changelogs, README files, or other user-facing documentation, foc...
-
Prefer Rust structural patterns
zed-industries/zed6⭐ 62119Use Rust's structural patterns to write more idiomatic and maintainable code. This includes: 1. Use early ...
-
Consider algorithmic complexity
zed-industries/zed6⭐ 62119When implementing algorithms, be mindful of their computational complexity and choose appropriate data stru...
-
prefer higher-level APIs
cloudflare/workerd6⭐ 6989When designing APIs, prefer using higher-level abstractions and established patterns over direct low-level ...
-
Node.js API compatibility
cloudflare/workerd6⭐ 6989When implementing Node.js-compatible APIs, ensure exact behavioral matching with Node.js, including export ...
-
minimize memory operations
cloudflare/workerd6⭐ 6989Avoid unnecessary memory allocations, copies, and inefficient memory usage patterns that can impact perform...
-
maintain consistent patterns
cloudflare/workerd6⭐ 6989Ensure consistent coding patterns and approaches are used throughout the codebase, even when multiple valid...
-
Use specific semantic names
microsoft/vscode6⭐ 174887Choose specific, descriptive names for identifiers that accurately reflect their purpose and behavior. Avoi...
-
Keep APIs simple JavaScript-like
microsoft/vscode6⭐ 174887Design APIs to be simple and idiomatic to JavaScript/TypeScript while maintaining proper encapsulation. Avo...
-
Handle errors with specificity
microsoft/vscode6⭐ 174887Always handle errors specifically and explicitly, avoiding generic catch blocks that mask or ignore errors....
-
Algorithm explanation clarity
volcano-sh/volcano6⭐ 4899When documenting algorithms, provide detailed explanations of the underlying logic with concrete examples a...
-
Use self-documenting names
vllm-project/vllm6⭐ 51730Variable, function, and parameter names should accurately reflect their purpose, behavior, and content. Cho...
-
Stable documentation links
vllm-project/vllm6⭐ 51730Ensure all documentation links are stable, consistent, and correctly targeted to improve navigation and lon...
-
Process configurations consistently
vllm-project/vllm6⭐ 51730Ensure that configuration data is processed consistently and correctly throughout the codebase. This includ...
-
Optimize data structures
vitessio/vitess6⭐ 19815Choose and implement data structures with careful consideration of algorithmic complexity, memory usage, an...
-
Ensure documentation accuracy
vitejs/vite6⭐ 74031Documentation must precisely reflect the current codebase implementation. When documenting features, option...
-
Make errors user actionable
astral-sh/uv6⭐ 60322Error messages should provide clear, actionable information that helps users understand and resolve the pro...
-
Validate production configurations
unionlabs/union6⭐ 74800Always validate configuration values and ensure production safety by avoiding hardcoded values, implementin...
-
Module resolution hierarchy
microsoft/typescript6⭐ 105378When configuring TypeScript projects, establish a clear understanding of module and type resolution hierarc...
-
Specify algorithmic scope precisely
astral-sh/ty6⭐ 11919When documenting changes to algorithms, data structures, or computational approaches, explicitly identify t...
-
Use semantically accurate names
twentyhq/twenty6⭐ 35477Names should clearly and accurately reflect their actual purpose, functionality, and scope. Avoid misleadin...
-
Use domain-specific exceptions
twentyhq/twenty6⭐ 35477Create custom exception classes for each domain/module instead of throwing generic errors or letting applic...
-
simplify API interfaces
twentyhq/twenty6⭐ 35477Keep API interfaces simple and focused by avoiding unnecessary input wrapping, extracting context parameter...
-
Know your implicit configurations
vercel/turborepo6⭐ 28115When working with Turborepo, be aware of implicit configurations and special files that affect behavior eve...
-
Eliminate code duplication
vercel/turborepo6⭐ 28115Avoid duplicating logic, patterns, or data across the codebase. When similar code appears in multiple place...
-
Optimize frequent operations
tree-sitter/tree-sitter6⭐ 21799Identify code paths that execute frequently (loops, hot functions, repeated calls) and optimize them by avo...
-
Algorithm and data optimization
tree-sitter/tree-sitter6⭐ 21799Choose efficient algorithms and appropriate data structures based on access patterns and computational requ...
-
complete observability router options
traefik/traefik6⭐ 55772When documenting router configuration options for any provider (Docker, Consul Catalog, ECS, KV stores, Nom...
-
Use Option methods idiomatically
tokio-rs/tokio6⭐ 28989When dealing with Optional values, prefer Rust's built-in Option methods over manual null checks. This make...
-
Structural configuration approaches
tokio-rs/tokio6⭐ 28989When working with feature flags and conditional compilation, prefer structural approaches over scattered co...
-
Prefer explicit over concise
tokio-rs/tokio6⭐ 28989Choose explicit and unambiguous names over concise but unclear ones. When a method, type, or variable has a...
-
Organize code logically
tokio-rs/tokio6⭐ 28989Group related code elements together with a consistent and logical structure. Place stable fields and funct...
-
Optimize memory allocation
tokio-rs/tokio6⭐ 28981Be deliberate about memory allocation patterns to improve performance. Implement these practices: 1. **Pre...
-
Network API design consistency
tokio-rs/tokio6⭐ 28989When designing networking APIs, maintain consistency with existing interfaces while ensuring proper cross-p...
-
Follow import style
tokio-rs/tokio6⭐ 28981Tokio projects follow specific import conventions for consistency and readability. Adhere to these guidelin...
-
Flexible consistent API patterns
tokio-rs/tokio6⭐ 28989Design APIs with flexibility and consistency by leveraging established patterns and avoiding unnecessary co...
-
Design error handling carefully
tokio-rs/tokio6⭐ 28989When implementing error handling, balance between propagation and recovery. Design error types to preserve ...
-
Simplify for readability
huggingface/tokenizers6⭐ 9868Prioritize code readability by using simpler and more direct expressions. When possible, return values dire...
-
Descriptive purpose-driven naming
hashicorp/terraform6⭐ 45532Choose identifiers that accurately describe their purpose and behavior, not just their type or how they're ...
-
Contextual null checks
hashicorp/terraform6⭐ 45532Use type-appropriate null checking strategies based on the context of your data. For primitive values, ensu...
-
Use established configuration patterns
microsoft/terminal6⭐ 99242When adding new configuration options or settings, leverage existing configuration frameworks and patterns ...
-
manage object lifetimes carefully
microsoft/terminal6⭐ 99242Ensure proper object lifetime management in concurrent scenarios to prevent crashes from dangling pointers ...
-
Choose efficient data structures
microsoft/terminal6⭐ 99242Select data structures and types that optimize for both memory usage and computational efficiency. Avoid un...
-
Choose efficient implementations
tensorflow/tensorflow6⭐ 190625When implementing algorithms, prioritize both correctness and performance by selecting appropriate data str...
-
Specific assertion methods
temporalio/temporal6⭐ 14953Use the most specific and descriptive assertion methods available in your test framework to improve test re...
-
Precompute and cache
temporalio/temporal6⭐ 14953Avoid performing expensive operations repeatedly, especially in hot code paths. Identify operations such as...
-
Comprehensive function documentation
gravitational/teleport6⭐ 19109Functions, methods, and non-trivial constants should include comprehensive documentation that explains thei...
-
document configuration hierarchies
sveltejs/svelte6⭐ 83580When documenting configuration options, clearly explain all available configuration levels and their preced...
-
Document complex APIs
sveltejs/svelte6⭐ 83580Require comprehensive JSDoc documentation for classes, complex functions, and all exported functions to imp...
-
Choose descriptive names
sveltejs/svelte6⭐ 83580Prioritize semantic clarity and descriptive naming over brevity or convenience. Avoid esoteric, abbreviated...
-
Prevent hardcoded secrets
supabase/supabase6⭐ 86070Never store sensitive information such as API keys, passwords, tokens, or credentials directly in your sour...
-
Use appropriate collections
spring-projects/spring-framework6⭐ 58382Choose the right collection implementation for each algorithmic task to optimize both performance and reada...
-
Meaningful exception design
spring-projects/spring-boot6⭐ 77637Design exceptions to provide clear context, preserve stack traces, and propagate correctly through your sys...
-
Documentation clarity principles
spring-projects/spring-boot6⭐ 77637When writing technical documentation, adhere to these core principles to ensure clarity and effectiveness: ...
-
Document configuration properties completely
spring-projects/spring-boot6⭐ 77637Configuration properties should be fully documented with clear descriptions, explicit default values, and p...
-
Concrete bean return types
spring-projects/spring-boot6⭐ 77637When defining `@Bean` methods in Spring configurations, use concrete return types rather than interfaces wh...
-
Alphabetical ordering requirement
spring-projects/spring-boot6⭐ 77637Always maintain alphabetical ordering for lists of elements including dependencies, modules, configuration ...
-
optimize data structures
apache/spark6⭐ 41554Choose appropriate data structures and algorithms to optimize computational complexity and performance. Con...
-
use loose equality checks
serverless/serverless6⭐ 46810Use loose equality (`== null`) instead of strict equality (`=== null` or `=== undefined`) when checking for...
-
configuration examples accuracy
serverless/serverless6⭐ 46810Ensure configuration examples and documentation use current, supported syntax and accurately reflect the ac...
-
avoid local imports
oraios/serena6⭐ 14465Place all import statements at the top of the file as global imports rather than importing modules within f...
-
Use descriptive identifiers
getsentry/sentry6⭐ 41297Choose variable, parameter, field, and class names that clearly communicate their purpose and context. Favo...
-
Structure logs with context
getsentry/sentry6⭐ 41297Use structured logging with appropriate context and log levels to maximize the value of log messages. Inclu...
-
Explicit null handling
getsentry/sentry-php6⭐ 1873Always be explicit and consistent when handling null values to improve code clarity and prevent subtle bugs...
-
Feature flag rollouts
getsentry/sentry6⭐ 41297Use feature flags to gate new functionality for controlled rollouts. This allows for quick enabling/disabli...
-
Structure validation algorithms
rust-lang/rust6⭐ 105254When implementing or modifying parsing and validation algorithms, carefully consider both the correctness a...
-
Clear helpful error messages
rust-lang/rust6⭐ 105254Create user-friendly error messages that guide developers toward solutions. Error messages should: 1. Inclu...
-
Optimize common paths
dotnet/runtime6⭐ 16578Design algorithms that optimize for the most common execution paths by prioritizing frequent scenarios in c...
-
Model actual hardware costs
dotnet/runtime6⭐ 16578Base optimization decisions on accurate hardware cost models rather than outdated assumptions. Modern archi...
-
Document configuration intent
dotnet/runtime6⭐ 16578Configuration settings should be self-documenting with clear intent. When adding temporary workarounds, con...
-
Handle nulls with Option
astral-sh/ruff6⭐ 40619Use Rust's Option type and its methods effectively to handle nullable values. This improves code clarity an...
-
Enhance code clarity
TanStack/router6⭐ 11590Ensure all code examples and documentation are as clear and complete as possible for developers. This inclu...
-
API parameter design
TanStack/router6⭐ 11590Design API parameters thoughtfully by making them optional when appropriate, avoiding unnecessary required ...
-
Maintain consistent naming patterns
RooCodeInc/Roo-Code6⭐ 17288Use consistent naming patterns throughout the codebase. When adding new identifiers, follow existing patter...
-
Enforce resource usage limits
RooCodeInc/Roo-Code6⭐ 17288Implement explicit resource limits and monitoring to prevent performance degradation and memory issues. Thi...
-
Enforce API format consistency
RooCodeInc/Roo-Code6⭐ 17288Maintain consistent data formats, parameter units, and interface patterns across API implementations. This ...
-
Use descriptive semantic names
remix-run/react-router6⭐ 55270Choose variable, function, and type names that clearly communicate their purpose and context. Prioritize re...
-
precise null type checking
remix-run/react-router6⭐ 55270Use precise null and undefined type checking that matches the actual usage context. Distinguish between che...
-
Hook dependencies stability
remix-run/react-router6⭐ 55270Ensure hook dependencies are minimal, stable, and follow React's rules to prevent unnecessary re-renders an...
-
configuration consistency standards
remix-run/react-router6⭐ 55270Ensure configuration options, flags, and environment settings are handled consistently across all commands ...
-
configuration compatibility validation
remix-run/react-router6⭐ 55270Ensure that code examples and documentation accurately reflect the constraints and requirements of differen...
-
Prefer simpler expressions
rails/rails6⭐ 57027Always choose the simplest, most readable way to express your code logic. Unnecessary complexity makes code...
-
Minimize unnecessary object allocations
rails/rails6⭐ 57027Avoid creating unnecessary objects, especially in frequently executed code paths. This includes being mindf...
-
Minimize public API surface
rails/rails6⭐ 57027Design APIs with a minimal public surface area by carefully controlling which methods and properties are ex...
-
Follow documentation conventions
rails/rails6⭐ 57027Maintain consistent formatting and style in all documentation to improve readability and professionalism: ...
-
Document APIs clearly
rails/rails6⭐ 57027When designing and documenting APIs, prioritize clarity and completeness through concrete examples and accu...
-
Thread-safe state management
quarkusio/quarkus6⭐ 14667When managing state accessed by multiple threads, ensure thread safety through appropriate synchronization ...
-
Graceful API evolution
pytorch/pytorch6⭐ 91345When modifying, deprecating, or replacing APIs, ensure a smooth transition experience for developers by fol...
-
Standardize dependency management
pydantic/pydantic6⭐ 24377Maintain consistent dependency management practices across CI workflows to ensure reliable builds and tests...
-
Maintain code consistency
pydantic/pydantic6⭐ 24377Ensure code follows consistent patterns throughout the codebase, even when duplicating code is necessary. W...
-
Least privilege principle
prowler-cloud/prowler6⭐ 11834Always follow the principle of least privilege by granting the minimum permissions necessary for functional...
-
improve code readability
prometheus/prometheus6⭐ 59616Structure code to maximize readability and reduce cognitive load through proper formatting and control flow...
-
avoid subjective language
prometheus/prometheus6⭐ 59616Avoid subjective terms, unexplained jargon, and assumptions about user knowledge in documentation. Replace ...
-
Manage output streams carefully
prisma/prisma6⭐ 42967Always consider the destination and lifecycle of output streams to prevent protocol interference, data loss...
-
Verify optional chaining necessity
prettier/prettier6⭐ 50772Analyze whether optional chaining (`?.`) is actually needed based on the surrounding context and prior vali...
-
prefer efficient algorithms
prettier/prettier6⭐ 50772Choose more efficient algorithmic approaches by leveraging built-in methods and APIs instead of implementin...
-
Documentation clarity standards
prettier/prettier6⭐ 50772Ensure documentation is clear, precise, and technically accurate to prevent confusion and build errors. Thi...
-
consistent spacing patterns
prettier/prettier6⭐ 50772Maintain consistent spacing patterns around operators, keywords, and interpolation syntax throughout the co...
-
Cache invalidation consistency
PostHog/posthog6⭐ 28460Ensure comprehensive and consistent cache invalidation patterns across all models that affect cached data. ...
-
Optimize memory allocation patterns
pola-rs/polars6⭐ 34296Minimize memory allocations and optimize allocation patterns to improve performance. Key practices: 1. Pre...
-
Names reveal clear intent
pola-rs/polars6⭐ 34296Choose names that clearly communicate intent and context, avoiding ambiguity or confusion. Variable and fun...
-
Explicit null handling
pola-rs/polars6⭐ 34296Always be explicit and consistent about how null values are handled in operations and documentation. This c...
-
Clear actionable error messages
python-poetry/poetry6⭐ 33496Error messages should be user-friendly, readable, and provide actionable guidance for resolution. Avoid exp...
-
proxy configuration precedence
microsoft/playwright6⭐ 76113Ensure proxy configuration follows proper precedence hierarchy and handles different proxy types correctly....
-
Extract repeated logic
microsoft/playwright6⭐ 76113When you find yourself writing similar code patterns multiple times, extract them into reusable methods, co...
-
comprehensive test coverage
emcie-co/parlant6⭐ 12205Ensure tests are comprehensive and explicit to prevent regressions and gaps in coverage. Tests should cover...
-
Structure tests thoroughly
opentofu/opentofu6⭐ 25901Create well-structured tests with thorough coverage of both expected success and error conditions. Name tes...
-
Safe lock patterns
opentofu/opentofu6⭐ 25901When implementing concurrent operations, ensure locks are acquired and released properly in all execution p...
-
Reduce code nesting
opentofu/opentofu6⭐ 25901Minimize nesting levels and complexity in your code to improve readability and maintainability. Use early r...
-
Write purposeful comments
open-telemetry/opentelemetry-python6⭐ 2061Comments should explain "why" and "how" rather than restating what is already obvious from the code. Focus ...
-
Sanitize observability data exports
open-telemetry/opentelemetry-python6⭐ 2061When exporting observability data (metrics, traces, logs) to external systems, properly sanitize all data f...
-
Use OpenCV error mechanisms
opencv/opencv6⭐ 82865Always use OpenCV's built-in error handling mechanisms instead of C++ exceptions or custom error handling. ...
-
Prevent null vulnerabilities
opencv/opencv6⭐ 82865Use container classes and smart pointers instead of manual memory allocation to prevent null pointer derefe...
-
Cross-platform API design rules
opencv/opencv6⭐ 82865Design public APIs to work seamlessly across different programming languages and platforms. Follow these ke...
-
Clear API contracts
opencv/opencv6⭐ 82865Design APIs with clear contracts that behave exactly as their names and signatures suggest. Functions shoul...
-
Optimize with standard library
ollama/ollama6⭐ 145704When implementing algorithms, prefer using Go's standard library over custom implementations or external de...
-
Use nullable for optionals
octokit/octokit.net6⭐ 2793When a property or parameter represents an optional value that might be absent in requests or responses, us...
-
validate configuration values
nrwl/nx6⭐ 27518Always validate configuration values at runtime and provide clear, actionable error messages when invalid c...
-
Use explicit, consistent names
nrwl/nx6⭐ 27518Variable and parameter names should be explicit about their purpose and consistent with established naming ...
-
scope CI access tokens
nrwl/nx6⭐ 27518Configure CI pipelines to use appropriately scoped access tokens based on branch protection status. Use rea...
-
Document CI configuration clearly
nrwl/nx6⭐ 27518Always include file path comments in CI configuration code blocks and use officially recommended setup acti...
-
Use descriptive names
nuxt/nuxt6⭐ 57769Choose variable, function, and file names that clearly describe their purpose, behavior, and content. Names...
-
explicit API design
nuxt/nuxt6⭐ 57769Design APIs with explicit parameters, consistent return types, and clear interfaces to improve usability an...
-
Configuration method selection
nuxt/nuxt6⭐ 57769Choose the appropriate configuration method based on when values are needed and whether they can change at ...
-
Use semantic naming patterns
novuhq/novu6⭐ 37700Establish consistent naming conventions that preserve semantic meaning and follow established patterns. Use...
-
Extract reusable components
novuhq/novu6⭐ 37700Eliminate code duplication by extracting common functionality into shared utilities, constants, and base cl...
-
Prefer clarity over cleverness
nodejs/node6⭐ 112178Write code that prioritizes readability and maintainability over cleverness or excessive optimization. Avoi...
-
Handling Dynamic Content in Next.js Components
vercel/next.js6⭐ 133000When implementing Next.js components that rely on dynamic content (e.g. random values, current time), it is...
-
Provider-specific AI handling
ChatGPTNextWeb/NextChat6⭐ 85721Implement provider-specific logic when integrating different AI services, as each provider has unique requi...
-
Use null validation utilities
netty/netty6⭐ 34227Consistently use utility methods like `ObjectUtil.checkNotNull()` or `Objects.requireNonNull()` to validate...
-
Memory ordering needs barriers
netty/netty6⭐ 34227Ensure proper memory ordering in concurrent code by using appropriate memory barriers and atomic operations...
-
Structure behavior-driven tests properly
nestjs/nest6⭐ 71766Organize tests using behavior-driven development (BDD) patterns to improve clarity and maintainability. Gro...
-
Follow protocol standards
nestjs/nest6⭐ 71767When implementing networking features, strictly adhere to protocol specifications and standards to ensure p...
-
prioritize code readability
neovim/neovim6⭐ 91433Write code that prioritizes readability and clarity over brevity. Use proper formatting, clear expressions,...
-
Follow established API patterns
neovim/neovim6⭐ 91433APIs should follow documented conventions and established patterns within the codebase to ensure consistenc...
-
Documentation accuracy standards
neovim/neovim6⭐ 91433Ensure all function documentation accurately reflects the actual code behavior and includes complete, prope...
-
Optimize cargo dependencies
neondatabase/neon6⭐ 19015Maintain clean and efficient dependency configurations in Cargo.toml files by following these practices: 1...
-
Minimize unnecessary allocations
neondatabase/neon6⭐ 19015Avoid allocations and cloning when they don't provide sufficient benefit relative to their performance cost...
-
Log level appropriately
neondatabase/neon6⭐ 19015Select the appropriate log level based on operational significance and ensure messages are clear, accurate,...
-
Keep files focused small
neondatabase/neon6⭐ 19015Maintain code organization by keeping files focused on a single responsibility and splitting large files in...
-
Standardize LLM interface parameters
n8n-io/n8n6⭐ 122978Maintain consistent parameter names and interface patterns across LLM implementations to improve maintainab...
-
Sanitize all dynamic content
n8n-io/n8n6⭐ 122978Always sanitize dynamic content before rendering to prevent XSS and injection attacks. This includes HTML c...
-
Never swallow errors silently
n8n-io/n8n6⭐ 122978Always handle errors explicitly and preserve their context. Never silently catch and discard errors as this...
-
Optimize iteration patterns
apache/mxnet6⭐ 20801When iterating through collections, choose the most efficient iteration pattern based on what information y...
-
Use descriptive names
rocicorp/mono6⭐ 2091Choose names that clearly communicate intent and purpose, avoiding vague or misleading terms. Names should ...
-
explicit null handling
rocicorp/mono6⭐ 2091Use explicit null and undefined checks with assertions to validate assumptions and maintain type safety. Pr...
-
Environment variable patterns
rocicorp/mono6⭐ 2091Use consistent patterns for environment variable handling and configuration validation. Access environment ...
-
Use theme utilities consistently
mui/material-ui6⭐ 96063Always use theme utilities for consistent styling across the application instead of hard-coded values. Repl...
-
Meaningful and consistent names
mui/material-ui6⭐ 96063Use descriptive, accurate identifiers that follow established conventions and maintain consistency througho...
-
Extract complex logic
mastodon/mastodon6⭐ 48691Break down complex methods into smaller, well-named private methods to improve readability and maintainabil...
-
Handle errors by severity
maplibre/maplibre-native6⭐ 1411Choose error handling mechanisms based on error severity and recoverability: 1. Use throws for unrecoverab...
-
Consistent API practices
maplibre/maplibre-native6⭐ 1411Maintain consistency in API design, documentation, and implementation across all supported platforms to imp...
-
Add explanatory documentation
logseq/logseq6⭐ 37695Add docstrings to functions and comments to explain complex logic, especially when the purpose or reasoning...
-
consistent naming patterns
lobehub/lobe-chat6⭐ 65138Maintain consistent naming conventions within related groups of identifiers. When naming related variables,...
-
Provide contextual code documentation
llvm/llvm-project6⭐ 33702Code should include documentation that explains the purpose, rationale, and context behind implementation d...
-
Follow naming conventions
ggml-org/llama.cpp6⭐ 83559Maintain consistency with established naming patterns and conventions throughout the codebase. This include...
-
explicit control flow logic
ggml-org/llama.cpp6⭐ 83559Use explicit control flow structures like switch statements instead of complex boolean logic or implicit re...
-
Use proper logging mechanisms
BerriAI/litellm6⭐ 28310Always use the logging library instead of print statements and maintain consistent logging patterns through...
-
Preserve error handling context
langfuse/langfuse6⭐ 13574Always preserve error context by using specific error types, safe error handling patterns, and meaningful e...
-
Maintain naming consistency
langfuse/langfuse6⭐ 13574Use consistent and descriptive names for variables, components, and functions throughout the codebase. When...
-
Hook and state correctness
langfuse/langfuse6⭐ 13574Ensure React hooks and state updates follow best practices to prevent subtle bugs: 1. **Call hooks uncondi...
-
Environment variable documentation
langflow-ai/langflow6⭐ 111046Ensure comprehensive and accurate documentation of environment variables, including cross-references, auto-...
-
Prefer nullish coalescing
langchain-ai/langchainjs6⭐ 15004When handling null or undefined values, use modern JavaScript patterns to write more robust and maintainabl...
-
Prefer descriptive errors
JetBrains/kotlin6⭐ 50857When handling errors in your code, always provide detailed context in error messages to aid debugging. Use ...
-
Use descriptive names
kilo-org/kilocode6⭐ 7302Choose names that clearly communicate purpose, type, and intent rather than generic or ambiguous identifier...
-
extract reusable utilities
kilo-org/kilocode6⭐ 7302When you notice repeated logic or functions that could be shared across multiple files, extract them into d...
-
Synchronization safety patterns
apache/kafka6⭐ 30575Ensure proper synchronization mechanisms to prevent deadlocks and race conditions in concurrent code. When ...
-
avoid unnecessary object creation
apache/kafka6⭐ 30575Minimize object allocation in performance-critical code paths by reusing existing objects, caching expensiv...
-
Choose efficient data structures
jj-vcs/jj6⭐ 21171Select data structures and algorithms based on their performance characteristics and expected usage pattern...
-
Return errors explicitly
istio/istio6⭐ 37192Functions should return errors explicitly to callers rather than terminating the program, hiding errors in ...
-
prevent race conditions
istio/istio6⭐ 37192Always protect shared state access and ensure proper synchronization in concurrent operations to prevent ra...
-
Feature flag lifecycle management
istio/istio6⭐ 37192Establish clear guidelines for feature flag creation, default values, and removal strategy based on risk as...
-
Avoid expensive operations
istio/istio6⭐ 37192Identify and eliminate computationally expensive operations in frequently executed code paths. Common expen...
-
Wrap errors with context
influxdata/influxdb6⭐ 30268Always wrap errors with meaningful context using fmt.Errorf and %w verb. Include relevant identifiers (file...
-
Follow API conventions
influxdata/influxdb6⭐ 30268Design APIs following modern conventions and best practices to improve usability, maintainability, and cons...
-
Choose optimal data structures
influxdata/influxdb6⭐ 30268Select data structures based on specific access patterns and performance requirements. When both fast looku...
-
Minimize redundant operations
elie222/inbox-zero6⭐ 8267Optimize application performance by preventing unnecessary renders, calculations, and network operations. I...
-
Handle nulls with types
elie222/inbox-zero6⭐ 8267Enforce type safety by properly handling null and undefined values through TypeScript types and explicit ch...
-
Enforce atomic database operations
elie222/inbox-zero6⭐ 8267Replace check-then-act patterns with atomic database operations to prevent race conditions in concurrent en...
-
Dynamic configuration handling
hyprwm/Hyprland6⭐ 28863When implementing configuration changes that need to be applied at runtime, follow these practices: 1. **U...
-
consistent naming conventions
hyprwm/Hyprland6⭐ 28863Follow the project's established naming conventions consistently across all code. Use camelCase for variabl...
-
Synchronize environment configurations
juspay/hyperswitch6⭐ 34028When making configuration changes, ensure all relevant environment files are updated consistently to preven...
-
Avoid hardcoded configuration values
juspay/hyperswitch6⭐ 34028Configuration values should not be hardcoded in the source code. Instead, they should be externalized to co...
-
prefer let-else patterns
helix-editor/helix6⭐ 39026When handling Option types that require early returns on None values, prefer the let-else pattern over verb...
-
Consistent descriptive naming conventions
helix-editor/helix6⭐ 39026Use consistent and descriptive naming conventions across the codebase: 1. Use kebab-case for configuration...
-
Explicit null validation
grafana/grafana6⭐ 68825Always validate objects for null/nil before accessing their properties, and establish consistent patterns f...
-
Descriptive semantic names
grafana/grafana6⭐ 68825Always use descriptive variable, parameter, function, and constant names that clearly convey their purpose ...
-
Use descriptive identifiers
block/goose6⭐ 19037Replace generic, ambiguous, or magic identifiers with descriptive, specific names that clearly communicate ...
-
avoid panics and expects
block/goose6⭐ 19037Replace panic-inducing operations like `.expect()` and `.unwrap()` with proper error handling that allows g...
-
avoid environment variable proliferation
block/goose6⭐ 19037Prefer the consolidated config system over adding new environment variables. Environment variables should o...
-
AI model configuration consistency
block/goose6⭐ 19037Maintain consistent AI model metadata and configuration across all providers to prevent breaking changes an...
-
Use proper network constants
golang/go6⭐ 129599When writing network-related code, always use named constants from system packages instead of magic numbers...
-
Document code behavior
gin-gonic/gin6⭐ 83022Document the "why" and "how" of your code, not just what it does. Add clear comments to explain: 1. Non-ob...
-
Robust SSH integration
ghostty-org/ghostty6⭐ 32864When implementing SSH integration in your application, follow these practices to ensure reliability across ...
-
Document configs comprehensively
ghostty-org/ghostty6⭐ 32864Configuration options must be documented comprehensively with: 1. Clear, descriptive name using appropriat...
-
Use semantic naming
google-gemini/gemini-cli6⭐ 65062Choose names that clearly communicate the purpose, behavior, and intent of variables, methods, classes, and...
-
Secure input validation
google-gemini/gemini-cli6⭐ 65062Always validate and sanitize user inputs, especially when constructing commands or file paths. Use establis...
-
Ensure comprehensive user documentation
google-gemini/gemini-cli6⭐ 65062All user-facing features, APIs, and tools must have clear, comprehensive documentation that explains their ...
-
Organize code logically
fatedier/frp6⭐ 95938Maintain a clean and logical code structure by properly organizing code according to its functionality and ...
-
Name indicates clear purpose
laravel/framework6⭐ 33763Names should clearly indicate their purpose, type, and behavior. This applies to methods, variables, and pa...
-
Cache expensive operations
laravel/framework6⭐ 33763Identify and cache results of expensive operations that may be called repeatedly during a request lifecycle...
-
Extract methods for clarity
flutter/flutter6⭐ 172252Break down large methods and extract repeated code patterns into smaller, focused methods or getters to imp...
-
explicit null validation
flutter/flutter6⭐ 172252Always validate null values explicitly rather than using silent fallbacks or implicit handling. When null v...
-
Algorithm precision handling
flutter/flutter6⭐ 172252Choose algorithms that handle edge cases and mathematical precision correctly to avoid subtle bugs and unex...
-
prefer existing APIs
gofiber/fiber6⭐ 37560When adding new functionality, prioritize reusing existing methods and interfaces rather than creating new ...
-
Extract duplicate logic
gofiber/fiber6⭐ 37560When code blocks become large or contain repetitive patterns, extract them into separate functions to impro...
-
Consistent test code style
fastify/fastify6⭐ 34000Maintain consistent and clear testing patterns by following these guidelines: use strict equality assertion...
-
Concurrent operations completion management
fastify/fastify6⭐ 34000When running concurrent operations in tests, ensure all operations complete before concluding the test. Rac...
-
Ensure comprehensive test coverage
electron/electron6⭐ 117644Always verify that tests cover all relevant scenarios, edge cases, and conditions rather than just the happ...
-
avoid redundant operations
electron/electron6⭐ 117644Identify and eliminate unnecessary duplicate operations, redundant function calls, and repeated computation...
-
Use configuration access methods
elastic/elasticsearch6⭐ 73104When accessing configuration settings, always use the appropriate type-safe accessor methods provided by th...
-
Robust test assertions
elastic/elasticsearch6⭐ 73104Use precise, informative assertions in tests to provide clear feedback when tests fail and verify the corre...
-
Prefer callbacks over blocking
elastic/elasticsearch6⭐ 73104Always structure concurrent code to use asynchronous callbacks instead of blocking operations. Blocking cal...
-
Measure before optimizing performance
elastic/elasticsearch6⭐ 73104Before implementing performance optimizations, measure and validate the impact through benchmarks. This app...
-
maintain codebase consistency
duckdb/duckdb6⭐ 32061Ensure new code follows established patterns, conventions, and standards already present in the codebase. T...
-
explicit null state management
duckdb/duckdb6⭐ 32061Make null state checks explicit and comprehensive rather than using implicit return values or redundant fie...
-
Explicit CI configurations
duckdb/duckdb6⭐ 32061CI/CD workflows should use explicit, named configurations rather than wildcards, globs, or implicit behavio...
-
Optional configuration parameters
stanfordnlp/dspy6⭐ 27813Make configuration parameters optional with sensible defaults instead of requiring mandatory values, and on...
-
Null safety patterns
stanfordnlp/dspy6⭐ 27813Implement proper null safety patterns to prevent runtime errors and unexpected behavior. This includes seve...
-
implement algorithms correctly
stanfordnlp/dspy6⭐ 27813Ensure algorithmic implementations use correct patterns, handle edge cases gracefully, and avoid silent fai...
-
API backward compatibility
stanfordnlp/dspy6⭐ 27813Maintain backward compatibility when evolving API interfaces by preserving existing method signatures and p...
-
AI configuration documentation
stanfordnlp/dspy6⭐ 27813Ensure AI model configurations and related documentation use precise terminology and provide clear, complet...
-
Write focused efficient tests
django/django6⭐ 84182Tests should be focused, efficient and meaningful. Follow these guidelines: 1. Avoid testing implementatio...
-
Use connection by alias
django/django6⭐ 84182When working with database operations in Django projects that might use multiple database backends, always ...
-
Use appropriate log levels
langgenius/dify6⭐ 114231Choose the correct logging level based on the importance and purpose of the message. Use DEBUG for debuggin...
-
Prefer exceptions over silent failures
langgenius/dify6⭐ 114231Raise exceptions instead of returning None, logging warnings, or silently modifying values when encounterin...
-
Concurrent resource management
langgenius/dify6⭐ 114231When implementing concurrent operations, properly manage shared resources to prevent race conditions and en...
-
organize code properly
zen-browser/desktop6⭐ 34711Maintain clean code organization by separating concerns into appropriate classes and files. Extract large f...
-
Validate and document nulls
deeplearning4j/deeplearning4j6⭐ 14036Always handle null values explicitly and consistently throughout your codebase to prevent null pointer exce...
-
Use descriptive names
cypress-io/cypress6⭐ 48850Choose names that clearly reveal the purpose and behavior of variables, functions, and methods. Names shoul...
-
function decomposition clarity
cypress-io/cypress6⭐ 48850Functions should be focused, concise, and easy to understand. Break down large functions (>100 lines) into ...
-
Consistent formatting preferences
cypress-io/cypress6⭐ 48850Follow consistent formatting and syntax patterns to improve code readability and maintainability. This incl...
-
Structure errors with intent
crewaiinc/crewai6⭐ 33945Implement error handling with clear intent and proper propagation. Follow these principles: 1. Use structu...
-
Write comprehensive test cases
vuejs/core6⭐ 50769Tests should thoroughly cover all code paths and edge cases. Each test case should: 1. Test distinct scenar...
-
Use appropriate logging levels
home-assistant/core6⭐ 80450Choose the correct logging level based on the nature and expected frequency of the event being logged. Foll...
-
Strict props event handling
vuejs/core6⭐ 50769Enforce strict typing and consistent handling of component props and events to ensure type safety, runtime ...
-
Evolve APIs gracefully
vuejs/core6⭐ 50769When modifying or extending APIs, prioritize backward compatibility while providing clear migration paths f...
-
ESLint configuration alignment
adonisjs/core6⭐ 18071Ensure your ESLint configuration matches the JavaScript language features used in your codebase to prevent ...
-
Choose semantic descriptive names
vuejs/core6⭐ 50769Names should be clear, descriptive and follow consistent patterns. Choose names that accurately reflect the...
-
Avoid redundant computations
vuejs/core6⭐ 50769Identify and eliminate redundant operations that cause performance bottlenecks by caching expensive functio...
-
Semantically consistent naming
continuedev/continue6⭐ 27819Names should accurately reflect their purpose and be used consistently throughout the codebase. This applie...
-
Handle unsafe operations safely
continuedev/continue6⭐ 27819Always wrap potentially unsafe operations (like JSON parsing, Buffer operations, or API calls) in try-catch...
-
Extract into helper functions
continuedev/continue6⭐ 27819Break down complex or deeply nested code into smaller, well-named helper functions to improve readability a...
-
Add logging without duplication
docker/compose6⭐ 35858When adding logging functionality to existing code, encapsulate the logging logic within methods or use par...
-
Use descriptive names
comfyanonymous/ComfyUI6⭐ 83726Choose descriptive, self-documenting names for constants, functions, parameters, and types that clearly com...
-
Hardware compatibility patterns
comfyanonymous/ComfyUI6⭐ 83726Implement proper hardware compatibility patterns when working with different GPU backends and AI frameworks...
-
gRPC interface consistency
cline/cline6⭐ 48299Ensure gRPC/RPC interfaces follow consistent patterns for return types, error handling, and method design. ...
-
Check before property access
cline/cline6⭐ 48299Always verify that parent objects and properties exist before accessing nested properties or calling method...
-
Pin dependency versions
snyk/cli6⭐ 5178Always pin dependencies to exact versions in package.json instead of using semantic version ranges (^, ~) t...
-
Never commit secrets
chef/chef6⭐ 7860Private cryptographic keys, certificates with private keys, and other secrets must never be committed to so...
-
Memoize expensive operations
chef/chef6⭐ 7860Cache results of expensive operations, especially shell commands and external queries, to avoid redundant e...
-
Keep actions versions current
chef/chef6⭐ 7860Always use the latest stable versions of GitHub Actions components in CI/CD workflows to avoid deprecated f...
-
Externalize configuration values
chef/chef6⭐ 7860Avoid hardcoding configuration values directly in scripts, especially for values that might change between ...
-
Choose semantic algorithms
chef/chef6⭐ 7860Select algorithms and data operations that match the semantic intent of your code rather than using conveni...
-
Document configuration consistently
bridgecrewio/checkov6⭐ 7667Ensure all configuration options are clearly documented and follow consistent naming and syntax conventions...
-
Select specific database fields
calcom/cal.com6⭐ 37732Always explicitly select only the database fields you actually need instead of using broad includes or fetc...
-
Check exceptions consistently
oven-sh/bun6⭐ 79093Always check for exceptions immediately after operations that might throw them, especially before using the...
-
Minimize unnecessary operations
Homebrew/brew6⭐ 44168Optimize performance by eliminating redundant operations and arranging code to avoid unnecessary computatio...
-
Follow established naming patterns
Homebrew/brew6⭐ 44168Names should be descriptive and consistent with existing patterns in the codebase. This applies to methods,...
-
Clear error recovery paths
Homebrew/brew6⭐ 44168Implement error handling that provides both clear recovery paths for users and graceful degradation for the...
-
Clear code examples
Homebrew/brew6⭐ 44168Documentation should include clear, actionable code examples that users can reliably follow. Avoid using am...
-
Comprehensive API documentation
boto/boto36⭐ 9417Always provide comprehensive API documentation that includes accurate examples, complete parameter descript...
-
Use consistent error types
better-auth/better-auth6⭐ 19651Always use the appropriate error classes and throwing mechanisms for consistent error handling across the c...
-
Explicit null handling
bazelbuild/bazel6⭐ 24489Always make null handling explicit through proper annotations, defensive checks, and clear documentation. U...
-
Avoid unnecessary computations
bazelbuild/bazel6⭐ 24489Before performing expensive operations, check if the work is actually needed or if more efficient alternati...
-
Use domain-specific type names
Azure/azure-sdk-for-net6⭐ 5809Types should be named with clear domain context rather than generic terms. Avoid single-word or overly gene...
-
Minimize memory allocations
Azure/azure-sdk-for-net6⭐ 5809Reduce garbage collection pressure and improve application performance by avoiding unnecessary memory alloc...
-
Document code reasoning
Azure/azure-sdk-for-net6⭐ 5809Add clear, concise comments that explain the "why" behind complex logic, non-obvious decisions, and implici...
-
Prefer simpler code constructs
tokio-rs/axum6⭐ 22100Always opt for simpler, more idiomatic code constructs over complex or verbose alternatives. This includes ...
-
Semantic naming conventions
aws/aws-sdk-js6⭐ 7628Use descriptive, semantic names for all code elements that clearly indicate their purpose and behavior. Fol...
-
Early return after errors
aws/aws-sdk-js6⭐ 7628When handling errors in asynchronous functions, always return immediately after invoking a callback with an...
-
Document APIs thoroughly
aws/aws-sdk-js6⭐ 7628All public API elements must be thoroughly documented with JSDoc annotations that clearly explain their pur...
-
Prefer early returns
argoproj/argo-cd6⭐ 20149Use early returns and guard clauses to reduce nesting levels and improve code readability. Instead of deepl...
-
Complete configuration examples
argoproj/argo-cd6⭐ 20149Configuration examples in documentation must be complete and reference authoritative sources to prevent dep...
-
Use language-specific syntax
appwrite/appwrite6⭐ 51959Code snippets must use the correct language-specific syntax and include all necessary imports to compile pr...
-
Synchronize configuration values
appwrite/appwrite6⭐ 51959Ensure all configuration values, particularly version numbers and environment variables, are consistent acr...
-
Secure authorization skip handling
appwrite/appwrite6⭐ 51959When using authorization bypass mechanisms like `Authorization::skip()`, ensure proper security validation ...
-
Markdown formatting consistency
ant-design/ant-design6⭐ 95882Ensure consistent markdown formatting in documentation by wrapping all technical terms, API names, property...
-
JSDoc deprecation formatting
ant-design/ant-design6⭐ 95882Ensure consistent formatting in JSDoc deprecation comments to improve API documentation clarity and develop...
-
Dependency versioning consistency
ant-design/ant-design6⭐ 95882Establish and maintain consistent dependency versioning strategies in package.json configuration. Choose be...
-
Use reactive signal patterns
angular/angular6⭐ 98611Prefer Angular's reactive signal patterns over manual subscription management and imperative approaches. Us...
-
leverage existing Angular patterns
angular/angular6⭐ 98611Before implementing new functionality, check if Angular already provides a suitable utility, service, or pa...
-
Validate user-controlled paths
apache/airflow6⭐ 40858Always validate and sanitize user-provided inputs used in file path operations to prevent path traversal at...
-
Standardize API parameter handling
apache/airflow6⭐ 40858Use consistent parameter handling patterns across API endpoints to ensure maintainability and predictable b...
-
Avoid code duplication
apache/airflow6⭐ 40858Extract repeated code patterns into reusable functions, variables, or constants to improve maintainability ...
-
Verify AI model capabilities
vercel/ai6⭐ 15590Always verify and accurately document AI model capabilities, supported formats, and limitations before impl...
-
Type-safe null handling
vercel/ai6⭐ 15590Use TypeScript's type system and modern JavaScript features to prevent null reference errors. **TypeScrip...
-
Keep tests simple
vercel/ai6⭐ 15590Tests should be straightforward, explicit, and free from complex logic or indirection. Avoid "magic" in tes...
-
Test actual functionality
cloudflare/agents6⭐ 2312Ensure tests verify real operations and integration scenarios rather than just basic concepts or type defin...
-
Use structured model metadata
zed-industries/zed5⭐ 62119Represent AI model information using structured data rather than hardcoded enumerations or conditionals. St...
-
Scope dependencies appropriately
zed-industries/zed5⭐ 62119Configure dependencies with their minimum necessary scope to maintain clean architecture and improve build ...
-
Document configuration constraints clearly
zed-industries/zed5⭐ 62119When defining configuration options, always clearly document parameter constraints, valid ranges, and behav...
-
Choose domain-specific semantic names
zed-industries/zed5⭐ 62119Names should clearly reflect their domain-specific meaning and purpose, avoiding generic or ambiguous terms...
-
Strict null checks
facebook/yoga5⭐ 18255Use explicit strict equality checks when testing for null or undefined values. Prefer `x === undefined` ove...
-
Explicit undefined state handling
facebook/yoga5⭐ 18255Always use explicit, well-defined representations for undefined, uninitialized, or invalid states instead o...
-
JSDoc documentation standards
cloudflare/workers-sdk5⭐ 3379All public functions and complex code should have proper JSDoc documentation. Functions must include clear ...
-
Configuration file consistency
cloudflare/workers-sdk5⭐ 3379Ensure consistent patterns for configuration files, proper exclusion of development artifacts, and clear en...
-
proper span lifecycle management
cloudflare/workerd5⭐ 6989Ensure spans are properly created, attached to async operations, and reported at appropriate times to maint...
-
Network resource state validation
cloudflare/workerd5⭐ 6989Always validate the state of network resources (sockets, streams, connections) before performing operations...
-
compatibility flag consistency
cloudflare/workerd5⭐ 6989Ensure compatibility flags follow consistent naming conventions, use explicit typing, and maintain proper u...
-
avoid unnecessary allocations
cloudflare/workerd5⭐ 6989Minimize object creation and memory copying operations to improve performance. Cache and reuse objects when...
-
Use structured logging
volcano-sh/volcano5⭐ 4899Always use structured logging methods like klog.InfoS and klog.ErrorS instead of unstructured methods like ...
-
Use descriptive consistent naming
volcano-sh/volcano5⭐ 4899Choose names that are self-explanatory, descriptive, and consistent across the codebase. Avoid abbreviated ...
-
Validate algorithmic operations carefully
vllm-project/vllm5⭐ 51730Mathematical and logical operations require careful validation to ensure correctness. Common issues include...
-
Remove unnecessary code elements
vllm-project/vllm5⭐ 51730Keep code clean and maintainable by removing unnecessary elements that add complexity without value: 1. Re...
-
Preserve API compatibility
vllm-project/vllm5⭐ 51730When modifying API interfaces, parameters, or argument behavior, ensure backward compatibility is maintaine...
-
Optimize memory allocation
vitessio/vitess5⭐ 19815Always allocate data structures with appropriate initial capacity and use memory-efficient data types to re...
-
Runtime-agnostic API design
vitejs/vite5⭐ 74031When designing APIs for systems that support multiple JavaScript runtimes, prioritize decoupling server sta...
-
Propagate errors with context
vitejs/vite5⭐ 74031Always propagate errors with proper context and recovery strategy. Use try-catch blocks for both synchronou...
-
Environment variable management
vitejs/vite5⭐ 74031When working with environment variables in Vite applications, be explicit about variable loading behavior a...
-
Runtime configurable defaults
vlang/v5⭐ 36582Prefer runtime-configurable values over hardcoded constants to allow users to customize behavior without re...
-
Secure configuration defaults
astral-sh/uv5⭐ 60322Establish secure default configurations in project metadata files to prevent accidental publishing and ensu...
-
Optimize CI/CD commands
astral-sh/uv5⭐ 60322Design CI/CD workflows to be efficient, consistent, and purposeful across all environments. When writing or...
-
Environment variable best practices
astral-sh/uv5⭐ 60322When implementing environment variable configuration: 1. Follow standard environment variable conventions:...
-
Raise exceptions properly
Unstructured-IO/unstructured5⭐ 12116Always ensure exceptions are properly raised and propagated rather than being logged and swallowed. Avoid p...
-
extensible parameter design
Unstructured-IO/unstructured5⭐ 12116Design API parameters to support future extension without breaking changes. Use string enums instead of boo...
-
Environment variable patterns
Unstructured-IO/unstructured5⭐ 12117Use consistent patterns for environment variable handling in shell scripts. Always provide sensible default...
-
Meaningful consistent identifiers
shadcn-ui/ui5⭐ 90568Choose descriptive, semantically accurate names for variables, types, and components that clearly communica...
-
Guard against undefined
microsoft/typescript5⭐ 105378Always protect against potential null or undefined values before attempting property access or method calls...
-
Extract complex logical expressions
microsoft/typescript5⭐ 105378Complex logical expressions should be extracted into well-named variables or functions to improve code read...
-
prefer type guards
twentyhq/twenty5⭐ 35477Use semantic type guards like `isDefined()` instead of basic type checks (`typeof`, simple null checks) or ...
-
Minimize hook re-renders
twentyhq/twenty5⭐ 35477Design React hooks to minimize unnecessary re-renders by avoiding common anti-patterns that cause performan...
-
Add tests for functionality
twentyhq/twenty5⭐ 35477New functionality should include corresponding tests to ensure code quality and maintainability. When intro...
-
Validate performance impact first
vercel/turborepo5⭐ 28115Always validate performance changes through profiling or benchmarking before implementation, and favor memo...
-
Design ergonomic APIs
vercel/turborepo5⭐ 28115Create APIs that are both easy to use correctly and hard to use incorrectly. Focus on: 1. **Use pattern ma...
-
Use meaningful identifiers
tree-sitter/tree-sitter5⭐ 21799Choose identifiers that accurately represent their purpose, semantics, and relationship to the codebase. Na...
-
Use descriptive identifiers
tree-sitter/tree-sitter5⭐ 21799Choose identifiers that clearly communicate their purpose, content, or role rather than using generic or ab...
-
Ensure documentation clarity
tree-sitter/tree-sitter5⭐ 21799Documentation should be clear, accurate, and provide meaningful information to users. Avoid misleading desc...
-
consistent formatting preferences
tree-sitter/tree-sitter5⭐ 21799Maintain consistent formatting and use concise, standard syntax throughout the codebase. This includes seve...
-
complete API documentation
traefik/traefik5⭐ 55772Ensure all API configuration options are fully documented with accurate default values, required field indi...
-
Structure feature flags strategically
tokio-rs/tokio5⭐ 28989Design feature flags to minimize dependency bloat while maximizing flexibility for users. Each optional dep...
-
Structure API doc blocks
tokio-rs/tokio5⭐ 28989Each public API documentation block should follow a consistent structure: 1. Start with a single-line summ...
-
Socket configuration guidance
tokio-rs/tokio5⭐ 28981When implementing networking APIs, always clearly document socket modes, configuration options, and platfor...
-
Optimize hot paths
tokio-rs/tokio5⭐ 28989Identify and optimize frequently executed code paths to improve performance. Hot paths have a significant i...
-
Graceful error handling
tokio-rs/tokio5⭐ 28981Prioritize graceful error handling over panicking by providing fallbacks and propagating rich context. When...
-
Fast deterministic tests
tokio-rs/tokio5⭐ 28989Avoid using real sleeps or delays in tests as they significantly slow down the test suite and can introduce...
-
Design flexible APIs
tokio-rs/tokio5⭐ 28981When designing APIs, prioritize flexibility, ergonomics, and intuitiveness to create better user experience...
-
Minimize memory allocations
huggingface/tokenizers5⭐ 9868Avoid unnecessary memory allocations to improve performance. Each allocation has both CPU and memory overhe...
-
Handle nullable types idiomatically
huggingface/tokenizers5⭐ 9868Use Rust's idiomatic patterns when working with Option and Result types to prevent panics and improve code ...
-
Use precise semantic names
hashicorp/terraform5⭐ 45532Choose names that accurately reflect the purpose and semantics of the entity being named. Avoid overloaded ...
-
Prefer modern authentication
hashicorp/terraform5⭐ 45532Always use modern identity-based authentication methods instead of static credentials when accessing extern...
-
Include descriptive documentation
hashicorp/terraform5⭐ 45532Provide complete, clear descriptions for all configuration elements in documentation. Every output, variabl...
-
Document function behavior completely
hashicorp/terraform5⭐ 45532Function and method documentation should accurately describe behavior, parameters, and any non-obvious aspe...
-
prefer const declarations
microsoft/terminal5⭐ 99242Use `const` for variables that are not modified after initialization, and avoid creating unnecessary tempor...
-
Validate quantization parameters carefully
tensorflow/tensorflow5⭐ 190625When implementing quantized operations in ML models, thoroughly validate quantization parameters to ensure ...
-
Validate before dereference
tensorflow/tensorflow5⭐ 190625Always check that pointers, optional values, and results of type casts are valid before dereferencing or us...
-
Optimize loop operations
tensorflow/tensorflow5⭐ 190625Minimize expensive operations within inner loops to improve performance. Key practices include: 1. Extract...
-
Informative error messages
tensorflow/tensorflow5⭐ 190625Error messages should be informative, actionable, and concise to help users quickly understand and fix issu...
-
Handle dynamic shapes
tensorflow/tensorflow5⭐ 190625When implementing tensor-based algorithms, avoid assumptions about fixed tensor shapes by not relying on di...
-
Optimize metrics label cardinality
temporalio/temporal5⭐ 14953Carefully manage metric label cardinality to prevent excessive memory usage and maintain system performance...
-
Domain-specific error boundaries
temporalio/temporal5⭐ 14953Define and use domain-specific error types within bounded contexts rather than relying on generic service e...
-
Design stable APIs
temporalio/temporal5⭐ 14953When designing APIs, prioritize long-term stability and compatibility to avoid breaking changes. Use reques...
-
Use appropriate testify assertions
gravitational/teleport5⭐ 19109Choose the most specific and appropriate testify assertion methods for your test scenarios to improve test ...
-
minimize unnecessary allocations
gravitational/teleport5⭐ 19109Avoid unnecessary memory allocations in performance-critical code paths, especially in frequently executed ...
-
Configuration requirements clarity
gravitational/teleport5⭐ 19109Configuration requirements and dependencies should be made explicit and prominent in documentation, not bur...
-
API consistency patterns
gravitational/teleport5⭐ 19109Maintain consistent API patterns and structures across different resource types and access methods within t...
-
Teach by example
tensorflow/swift5⭐ 6136Present concepts through clear, focused examples that demonstrate features positively rather than through c...
-
Explicit configuration validation
SWE-agent/SWE-agent5⭐ 16839Avoid using configuration values as implicit feature flags or logic triggers. Instead, validate configurati...
-
prefer testing libraries
sveltejs/svelte5⭐ 83580When testing components, use established testing libraries like @testing-library/svelte instead of low-leve...
-
defensive error handling
sveltejs/svelte5⭐ 83580Add defensive checks and proper error handling to prevent crashes and handle edge cases gracefully. This in...
-
avoid expensive operations
sveltejs/svelte5⭐ 83580Identify and eliminate computationally expensive operations through early termination, better data structur...
-
Structure components with clarity
supabase/supabase5⭐ 86070Maintain clean and logical component organization by following these guidelines: 1. Keep related files tog...
-
Clear, descriptive identifiers
supabase/supabase5⭐ 86070Choose variable, component, and parameter names that clearly describe their purpose and avoid ambiguity. Na...
-
Use structured logging consistently
browserbase/stagehand5⭐ 16443Always use the established logging framework instead of console.log or ad-hoc logging approaches. This ensu...
-
Use descriptive names
browserbase/stagehand5⭐ 16443Choose descriptive, domain-specific names that clearly communicate intent and prevent confusion. Avoid gene...
-
Provide contextual error messages
browserbase/stagehand5⭐ 16443Error messages should include specific context about what went wrong and provide actionable guidance for re...
-
Leverage TypeScript null safety
browserbase/stagehand5⭐ 16443Use TypeScript's type system proactively to prevent null and undefined issues at compile time rather than h...
-
Respect annotation processing order
spring-projects/spring-framework5⭐ 58382When designing Spring components, pay careful attention to the order in which annotations are processed, es...
-
Design for API extension
spring-projects/spring-framework5⭐ 58382When designing APIs, prioritize extensibility by providing clear extension points and avoiding direct expos...
-
Cleanup error handling
spring-projects/spring-framework5⭐ 58382When handling resources that require cleanup (like streams, connections, or transactions), ensure that erro...
-
API boundary null handling
spring-projects/spring-framework5⭐ 58382Establish consistent null handling patterns at API boundaries to prevent null pointer exceptions and improv...
-
Property description conventions
spring-projects/spring-boot5⭐ 77637When documenting configuration properties in Spring Boot applications, follow these conventions for clarity...
-
prefer simple APIs
apache/spark5⭐ 41554Design APIs with simplicity in mind by avoiding unnecessary method overloads, reducing configuration option...
-
Include contextual information
apache/spark5⭐ 41554Log messages should include comprehensive contextual information to support debugging and system monitoring...
-
avoid unnecessary computations
apache/spark5⭐ 41554Prevent performance degradation by avoiding unnecessary expensive operations such as premature execution, r...
-
Use appropriate error types
SigNoz/signoz5⭐ 23369Always use semantically correct error types and codes that match the actual failure scenario. This ensures ...
-
Centralize configuration management
SigNoz/signoz5⭐ 23369Consolidate configuration parameters into centralized config structures instead of using scattered options ...
-
Use descriptive names
sgl-project/sglang5⭐ 17245Choose variable, function, and parameter names that accurately reflect their content, type, and purpose. Av...
-
conditional CI execution
servo/servo5⭐ 32962Use appropriate conditional statements in CI workflows to ensure steps execute under the right circumstance...
-
Structure configs for clarity
serverless/serverless5⭐ 46810Organize configuration objects to maximize clarity and maintainability while ensuring robust validation. Fo...
-
API clarity and consistency
serverless/serverless5⭐ 46810Ensure API configurations, documentation, and terminology are clear, consistent, and properly organized. Gr...
-
exact assertion testing
oraios/serena5⭐ 14465Tests should verify exact expected results rather than generic existence checks. Avoid assertions like `isi...
-
Secure sensitive data
getsentry/sentry5⭐ 41297Always protect sensitive data through proper encryption, secure cookies, and careful exception handling to ...
-
Remove unnecessary code elements
getsentry/sentry5⭐ 41297Keep code clean and maintainable by removing unnecessary elements. This includes: 1. Omit type annotations...
-
Prevent N+1 database queries
getsentry/sentry5⭐ 41297Avoid N+1 database queries by using appropriate Django ORM features like select_related(), prefetch_related...
-
Propagate errors with context
getsentry/sentry-php5⭐ 1873Always propagate errors appropriately by rethrowing caught exceptions and maintaining error context. Catch ...
-
Document API changes
getsentry/sentry-php5⭐ 1873When documenting API changes, particularly breaking changes, follow these practices to ensure clarity and e...
-
Defensive null checking
getsentry/sentry5⭐ 41297Implement defensive null checking to prevent NoneType errors, KeyError, and IndexError exceptions. When acc...
-
Choose efficient algorithms
semgrep/semgrep5⭐ 12598When implementing algorithms, prioritize computational efficiency by selecting appropriate data structures ...
-
Fail fast explicitly
strands-agents/sdk-python5⭐ 4044Always throw exceptions for error conditions rather than silently failing, logging warnings, or attempting ...
-
explicit null checks
strands-agents/sdk-python5⭐ 4044Use explicit existence checks rather than value-based null checks, and be intentional about failing fast ve...
-
comprehensive test assertions
strands-agents/sdk-python5⭐ 4044Write robust test assertions that verify complete objects and behaviors rather than individual properties. ...
-
Complete docstring documentation
strands-agents/sdk-python5⭐ 4044Ensure all classes, methods, and properties have comprehensive docstrings that clearly explain their purpos...
-
AI provider normalization
strands-agents/sdk-python5⭐ 4044When integrating multiple AI model providers, implement proper abstraction layers to normalize differences ...
-
Name for semantic meaning
rust-lang/rust5⭐ 105254Choose names that clearly convey the semantic meaning and purpose of the identifier, rather than using clev...
-
Document lock behavior
rust-lang/rust5⭐ 105254When implementing or documenting synchronization primitives, always clearly specify how locks behave under ...
-
Benchmark before optimizing code
rust-lang/rust5⭐ 105254Always validate performance optimizations with benchmarks before implementation. Ensure measurements accoun...
-
Prevent null references
dotnet/runtime5⭐ 16578Use defensive coding practices to prevent null reference exceptions by properly handling potentially null v...
-
Maintainable test structure
dotnet/runtime5⭐ 16578Write tests that are maintainable, self-documenting, and that promote good testing practices: 1. **Use pro...
-
Document code meaningfully
dotnet/runtime5⭐ 16578Provide meaningful documentation that enhances code maintainability and understanding. Follow these practic...
-
Cache expensive computations
dotnet/runtime5⭐ 16578Avoid recomputing expensive operations by caching results when they will be used multiple times. This appli...
-
Avoid busy waiting
dotnet/runtime5⭐ 16578When implementing concurrent code that waits for conditions to be met, avoid busy-wait loops that continuou...
-
Abstract traversal patterns
dotnet/runtime5⭐ 16578When implementing algorithms that operate on complex data structures (trees, graphs, dominator structures),...
-
Use descriptive identifiers
astral-sh/ruff5⭐ 40619Avoid abbreviations in variable, parameter, and method names to improve code readability and maintainabilit...
-
Profile allocations before optimization
astral-sh/ruff5⭐ 40619Before implementing data structures or algorithms, analyze allocation patterns and optimize for common case...
-
Document component behavior comprehensively
astral-sh/ruff5⭐ 40619Documentation should clearly explain the purpose, behavior, and relationships between code components using...
-
Consider algorithmic complexity tradeoffs
astral-sh/ruff5⭐ 40619When implementing algorithms or data structures, carefully evaluate the tradeoffs between computational com...
-
validate configuration schemas
TanStack/router5⭐ 11590Always validate configuration objects using proper schema validation (like Zod) before type casting or usin...
-
validate before accessing
TanStack/router5⭐ 11590Always validate that values exist and have expected properties before accessing them, especially when remov...
-
Use parameterized testing
TanStack/router5⭐ 11590When testing multiple scenarios with similar logic, use your testing framework's built-in parameterized tes...
-
Maintain comprehensive documentation
TanStack/router5⭐ 11590When making code changes, ensure all relevant documentation is updated comprehensively across different for...
-
explicit error type handling
TanStack/router5⭐ 11590Handle errors with explicit type checking and intentional decisions rather than generic catch-all approache...
-
Configuration option consistency
TanStack/router5⭐ 11590Ensure configuration options follow consistent naming conventions and are documented accurately. Use "defau...
-
Write resilient test assertions
RooCodeInc/Roo-Code5⭐ 17288Write test assertions that are resilient to implementation changes by focusing on behavior rather than impl...
-
Use structured logging
RooCodeInc/Roo-Code5⭐ 17288Replace direct `console.log`, `console.warn`, and `console.error` calls with a centralized logging abstract...
-
Prevent duplicate keys
RooCodeInc/Roo-Code5⭐ 17288Always ensure configuration files, especially JSON files, have unique keys. Duplicate keys can cause unpred...
-
maintain naming consistency
remix-run/react-router5⭐ 55270Ensure consistent naming conventions across the entire codebase, including terminology, file names, directo...
-
dependency version ranges
remix-run/react-router5⭐ 55270When configuring dependencies in package.json, use version ranges that maintain backwards compatibility and...
-
Configure rendering modes clearly
remix-run/react-router5⭐ 55270Ensure clear distinction and proper handling between different rendering modes (SSR, SSG, SPA) with appropr...
-
API naming consistency
remix-run/react-router5⭐ 55270Ensure related APIs use consistent naming patterns, parameter structures, and calling conventions across th...
-
validate before accessing
facebook/react-native5⭐ 123178Always validate parameters for both null values and correct types before accessing their properties or meth...
-
Prefer micro-optimizations
facebook/react-native5⭐ 123178Apply small performance improvements that accumulate to significant gains. Focus on efficient memory usage,...
-
Early returns prevent waste
facebook/react-native5⭐ 123178Add early return statements and duplicate checks to avoid unnecessary computations, memory allocations, and...
-
Document configuration logic
facebook/react-native5⭐ 123178Always add clear, explanatory comments for conditional configuration logic, architectural decisions, and pl...
-
avoid Hungarian notation
facebook/react-native5⭐ 123178Do not use Hungarian notation prefixes (like `m`, `s`) in variable and field names. Use descriptive, semant...
-
Write complete API examples
rails/rails5⭐ 57027Always provide complete, context-rich code examples in API documentation. Examples should show the full usa...
-
Place configurations appropriately
rails/rails5⭐ 57027Choose the right location and scope for your Rails configuration options to improve maintainability and cla...
-
Initialize nil-prone variables
rails/rails5⭐ 57027Always initialize variables that might be nil to appropriate default values to prevent unexpected behavior....
-
Prefer Optional over nulls
quarkusio/quarkus5⭐ 14667Use Java's Optional API instead of null checks to improve code readability, safety, and maintainability. Wh...
-
Optimize algorithmic operations
quarkusio/quarkus5⭐ 14667Before implementing or modifying algorithms, carefully evaluate data structure properties and operation cos...
-
Name for meaning first
quarkusio/quarkus5⭐ 14667Choose names that prioritize domain meaning and clarity over implementation details. This applies to method...
-
Document public APIs
quarkusio/quarkus5⭐ 14667All public APIs, interfaces, and methods should include comprehensive JavaDoc that clearly explains their p...
-
Clear database configuration examples
quarkusio/quarkus5⭐ 14667Database configuration examples in documentation should be correct, minimal, and include proper context. Pr...
-
Use higher-level iterations
pytorch/pytorch5⭐ 91345When working with multiple sequences that need to be combined, prefer higher-level iteration abstractions o...
-
Prevent null pollution
pytorch/pytorch5⭐ 91345Design your code to minimize the unexpected introduction of None values into data structures and APIs. Use ...
-
Handle errors specifically
pytorch/pytorch5⭐ 91345Always be explicit and specific when handling errors rather than using catch-all approaches or implicit con...
-
Robust error messaging
pydantic/pydantic5⭐ 24377Create clear, specific, and actionable error messages that help users understand and resolve issues, while ...
-
Eliminate redundant computation
pydantic/pydantic5⭐ 24377Identify and eliminate redundant or duplicate computation paths in your code, especially for expensive oper...
-
Cache expensive computations
pydantic/pydantic5⭐ 24377Implement strategic caching and memoization for expensive or frequently repeated computations to avoid redu...
-
Secure authentication flows
prowler-cloud/prowler5⭐ 11834Implement authentication flows that protect sensitive information and follow secure credential management p...
-
Safe attribute access patterns
prowler-cloud/prowler5⭐ 11834Implement consistent patterns for safely accessing potentially null or undefined attributes and dictionary ...
-
Prioritize code readability
prowler-cloud/prowler5⭐ 11834Write code that optimizes for human readability and understanding. Complex expressions, while technically c...
-
Consistent naming patterns
prowler-cloud/prowler5⭐ 11834Follow systematic naming conventions for types, interfaces, and functions to enhance code readability and n...
-
simplify test structure
prometheus/prometheus5⭐ 59616Write tests that are direct, focused, and free of unnecessary complexity. Remove redundant test fields, use...
-
explicit test assertions
prometheus/prometheus5⭐ 59616Tests should explicitly assert both positive and negative expectations to make test intentions clear and pr...
-
avoid panics gracefully
prometheus/prometheus5⭐ 59616Never use panic() for error handling in production code paths, especially in core engine components. Instea...
-
Avoid unnecessary allocations
prisma/prisma5⭐ 42967Minimize memory allocations by avoiding intermediate objects, sharing underlying buffers, and eliminating u...
-
validate configuration values
prettier/prettier5⭐ 50772Always validate configuration values and provide clear, actionable error messages when validation fails. Ha...
-
Modern configuration formats
prettier/prettier5⭐ 50772Prefer ES module configuration files with TypeScript annotations over JSON formats for better developer exp...
-
Add explanatory comments
prettier/prettier5⭐ 50772Add explanatory comments for complex logic, special cases, or non-obvious code behavior. Comments should ex...
-
Maintain naming consistency
PostHog/posthog5⭐ 28460Ensure consistent naming conventions, terminology, and identifiers across the entire codebase. Names should...
-
eliminate code duplication
PostHog/posthog5⭐ 28460Actively identify and eliminate code duplication in all its forms to improve maintainability and reduce bug...
-
Cache expensive operations
PostHog/posthog5⭐ 28460Identify and eliminate redundant expensive operations by implementing caching, memoization, or conditional ...
-
break down large functions
PostHog/posthog5⭐ 28460Large functions that handle multiple responsibilities should be decomposed into smaller, focused functions ...
-
Hide implementation details
pola-rs/polars5⭐ 34296Design public APIs to hide implementation details and focus on the user's mental model of the system. Avoid...
-
Explicit configuration precedence
pola-rs/polars5⭐ 34296Implement a clear configuration resolution chain that follows a consistent precedence pattern: explicit par...
-
Evaluate algorithmic complexity tradeoffs
pola-rs/polars5⭐ 34296When implementing algorithms, carefully evaluate tradeoffs between performance optimizations and code maint...
-
Documentation clarity standards
python-poetry/poetry5⭐ 33496Ensure documentation is grammatically correct, clearly structured, and uses precise terminology. Avoid verb...
-
Configure HTTP requests properly
python-poetry/poetry5⭐ 33496When making HTTP requests, use standard library enums for status codes, set appropriate timeouts, and handl...
-
Synchronous event handlers
microsoft/playwright5⭐ 76113Keep event handlers synchronous to prevent race conditions and timing issues. Async operations within event...
-
comprehensive test coverage
microsoft/playwright5⭐ 76113Tests should be comprehensive and cover edge cases, complete scenarios, and use specific assertions rather ...
-
API parameter clarity
microsoft/playwright5⭐ 76113Design API parameters to be self-documenting and minimize cognitive overhead. Avoid boolean parameters in f...
-
preserve exception context
emcie-co/parlant5⭐ 12205When handling exceptions, preserve the original exception context and provide clear, actionable error infor...
-
Names reflect exact purpose
emcie-co/parlant5⭐ 12205Choose names that precisely reflect the component's purpose and behavior, avoiding ambiguous terms or short...
-
LLM provider abstraction
emcie-co/parlant5⭐ 12205When integrating with different LLM providers, create proper base class abstractions that filter and valida...
-
Document with examples
opentofu/opentofu5⭐ 25901Always include clear, contextual examples when documenting APIs, interfaces, or command-line functionality....
-
Defensive null handling
opentofu/opentofu5⭐ 25901Always initialize data structures before use, particularly before accessing them in loops or conditional bl...
-
Clear concise documentation
opentofu/opentofu5⭐ 25901Write documentation that is direct, consistent, and appropriately detailed. Follow these principles: 1. **...
-
Optimize configuration structure
open-telemetry/opentelemetry-python5⭐ 2061Structure configuration files like tox.ini to maximize maintainability and efficiency. Use factor prefixes ...
-
Handle exceptions appropriately
open-telemetry/opentelemetry-python5⭐ 2061When implementing error handling logic, be deliberate about which exception types you catch and where you h...
-
Follow Python naming conventions
open-telemetry/opentelemetry-python5⭐ 2061Use consistent Python naming conventions to improve code readability and maintainability: 1. Use snake_cas...
-
Configuration source precedence
open-telemetry/opentelemetry-python5⭐ 2061Define and document a clear precedence order when configurations come from multiple sources (code parameter...
-
Use environment variables
commaai/openpilot5⭐ 58214Make configuration values configurable through environment variables with sensible defaults instead of hard...
-
use context managers concurrency
commaai/openpilot5⭐ 58214When working with concurrent operations involving shared resources or processes, use context managers and e...
-
eliminate unnecessary code
commaai/openpilot5⭐ 58214Remove redundant code constructs and prefer concise, direct patterns that improve readability and maintaina...
-
Context-aware algorithm selection
opengrep/opengrep5⭐ 1546Choose algorithms and data structures based on operational requirements and usage context rather than defau...
-
Optimize memory allocation patterns
opencv/opencv5⭐ 82865Prefer efficient memory allocation patterns to improve performance. Key practices: 1. Use RAII containers ...
-
Optimize container access
opencv/opencv5⭐ 82865Choose efficient container types and optimize access patterns in performance-critical code. Avoid operation...
-
Maintain code consistency
opencv/opencv5⭐ 82865Keep code clean and consistent with established project conventions. This includes: 1. Follow existing for...
-
Guard optional dependencies
opencv/opencv5⭐ 82865Configuration management requires careful handling of optional dependencies in both build scripts and sourc...
-
Use idiomatic Go flow
ollama/ollama5⭐ 145704Follow Go's idiomatic control flow patterns to improve code readability and maintainability. Key practices ...
-
Use environment variables
ollama/ollama5⭐ 145704Use environment variables instead of hardcoding configuration values such as file paths, port numbers, or s...
-
Guard against nil
ollama/ollama5⭐ 145704Always check for nil values and successful type assertions before accessing or dereferencing objects, espec...
-
Document synchronization intent
ollama/ollama5⭐ 145704Always clearly document the purpose and scope of synchronization primitives (mutexes, read-write locks) by:...
-
Comprehensive test coverage
ollama/ollama5⭐ 145704Test functions should provide comprehensive coverage of both expected and edge cases. Include tests for: 1...
-
Clear recoverable error messages
ollama/ollama5⭐ 145704Error messages should be clear, actionable, and indicate whether recovery is possible. When designing error...
-
Abstract model operations cleanly
ollama/ollama5⭐ 145704When implementing AI model operations, create clean abstractions through interfaces that separate core math...
-
Design intuitive API methods
octokit/octokit.net5⭐ 2793When designing API methods, prioritize intuitive usage patterns and backwards compatibility. Follow these g...
-
Verify configuration paths
nrwl/nx5⭐ 27518Ensure configuration property paths are accurate and complete, especially for nested configurations and con...
-
Use nullish coalescing operators
nrwl/nx5⭐ 27518Prefer modern JavaScript nullish coalescing (`??`) and optional chaining (`?.`) operators over verbose cond...
-
minimize resource usage
nrwl/nx5⭐ 27518Optimize performance by being selective about resource consumption - process only necessary data, avoid red...
-
Follow Vue API patterns
nuxt/nuxt5⭐ 57769Always prefer Vue's native APIs and follow official Vue patterns instead of creating custom implementations...
-
explicit response types
nuxt/nuxt5⭐ 57769Always specify explicit response types when making API calls, especially for prerendered routes or external...
-
Extract repeated patterns
novuhq/novu5⭐ 37700Extract repeated code patterns, CSS classes, and constants to improve maintainability and reduce duplicatio...
-
Environment variable fallbacks
novuhq/novu5⭐ 37700Always implement proper fallback chains for environment variables and handle missing configuration graceful...
-
contextual API parameters
novuhq/novu5⭐ 37700Design APIs to provide contextual information and adapt behavior based on current usage context. Pass conte...
-
Use modern C++ features
nodejs/node5⭐ 112178Embrace modern C++20 features throughout the codebase to improve code readability, maintainability, and per...
-
Thread-safe resource management patterns
nodejs/node5⭐ 112178Ensure thread-safe access to shared resources while following proper resource management patterns. When imp...
-
Standardize null pointer checks
nodejs/node5⭐ 112178Always use standard null-checking patterns like CHECK_NOT_NULL for pointer validation instead of manual nul...
-
Propagate errors with context
nodejs/node5⭐ 112178Always propagate errors with their original context instead of swallowing them or throwing new errors that ...
-
Minimize configuration dependencies
nodejs/node5⭐ 112178Keep configuration dependencies minimal and platform-aware. Avoid including unnecessary configuration files...
-
Follow consistent naming patterns
nodejs/node5⭐ 112178Maintain consistent naming conventions throughout the codebase to improve readability and reduce confusion....
-
Document with precise accuracy
nodejs/node5⭐ 112178Maintain precise and accurate documentation through both JSDoc annotations and explanatory comments. Ensure...
-
Behavior-focused test design
nodejs/node5⭐ 112178Tests should focus on verifying behavior rather than implementation details to ensure they remain robust du...
-
Write robust assertions
vercel/next.js5⭐ 133000When writing tests, ensure assertions can handle non-deterministic content while providing clear failure co...
-
Optimize Next.js Resource Utilization
vercel/next.js5⭐ 133000As a code reviewer, I recommend the following practices to optimize resource utilization when implementing ...
-
Release resources consistently
netty/netty5⭐ 34227Always ensure resources are properly released, especially in exception paths. Use try-finally blocks to gua...
-
Use consistent curly braces
nestjs/nest5⭐ 71767Always use curly braces for conditional statements and loops, even for single-line bodies. This maintains c...
-
Strategic dependency configuration
nestjs/nest5⭐ 71766Configure dependencies in package.json strategically based on how they're used in your project: 1. **Direc...
-
Standardize null safety patterns
nestjs/nest5⭐ 71766Use modern JavaScript features and utility functions consistently for null/undefined checks. Prefer optiona...
-
Preserve public API stability
nestjs/nest5⭐ 71767When modifying or extending public interfaces, ensure changes maintain backward compatibility and follow pr...
-
Preserve API interface stability
nestjs/nest5⭐ 71766When modifying or extending public API interfaces, ensure backward compatibility and proper versioning. Fol...
-
Modern null safety patterns
nestjs/nest5⭐ 71767Leverage modern JavaScript features and utility functions for safer null/undefined handling. This reduces c...
-
Avoid testing anti-patterns
nestjs/nest5⭐ 71767Ensure your tests actually validate functionality by avoiding common testing anti-patterns: 1. **Don't moc...
-
validate early, fail fast
neovim/neovim5⭐ 91433Perform comprehensive input validation and precondition checks at the beginning of functions, before execut...
-
Provide helpful documentation context
neovim/neovim5⭐ 91433Documentation should include sufficient context, practical examples, and helpful hints to make it truly use...
-
prefer concise expressions
neovim/neovim5⭐ 91433Write concise, readable code by choosing the most direct expression for simple operations. Use ternary oper...
-
Use descriptive identifiers
neondatabase/neon5⭐ 19015Choose clear, meaningful names for variables, parameters, and constants that convey their purpose without r...
-
Stage configuration changes gradually
neondatabase/neon5⭐ 19015When introducing configuration changes that affect multiple system components, implement them in stages to ...
-
Hierarchical semantic naming
neondatabase/neon5⭐ 19015Use hierarchical prefixes and clear descriptive names to indicate the domain, source, and purpose of code e...
-
Flexible documented configurations
neondatabase/neon5⭐ 19015Create configuration interfaces that are flexible, well-documented, and future-proof. When designing config...
-
Document concurrency design decisions
neondatabase/neon5⭐ 19015Always document key concurrency design decisions in code, including: 1. Locking protocols and ordering betw...
-
Design metrics for insights
neondatabase/neon5⭐ 19015Design metrics that provide actionable insights while maintaining system efficiency. Follow these key princ...
-
Comprehensive code documentation
neondatabase/neon5⭐ 19015Properly document code with clear, accurate, and useful comments using the correct syntax based on context:...
-
Validate API data contracts
n8n-io/n8n5⭐ 122978Always validate API request and response data using schema validation to ensure type safety and prevent run...
-
Optimize loop operations
n8n-io/n8n5⭐ 122978Avoid repeated computations and object creation in loops or high-frequency operations. Move invariant calcu...
-
Manage database connections
n8n-io/n8n5⭐ 122978Always properly manage database connections to prevent resource leaks and improve application stability. Im...
-
Use intent-revealing names
apache/mxnet5⭐ 20801Choose names that clearly reveal the purpose, behavior, or type of the code elements they represent. A good...
-
Hybridization compatible operations
apache/mxnet5⭐ 20801When implementing neural network models that will be hybridized for performance optimization, use operation...
-
Explain optimization mechanisms
apache/mxnet5⭐ 20801When implementing or documenting performance optimizations, clearly explain the mechanism and expected perf...
-
Document all parameters
apache/mxnet5⭐ 20801Always provide complete and accurate documentation for all function parameters, especially when adding new ...
-
preserve error context
rocicorp/mono5⭐ 2091When propagating errors through promise rejections, catch blocks, or error transformations, always preserve...
-
minimize hot path allocations
rocicorp/mono5⭐ 2091Reduce memory allocations and garbage collection pressure in frequently executed code paths. Object creatio...
-
avoid unnecessary computations
rocicorp/mono5⭐ 2091Optimize algorithms by eliminating redundant work and intermediate data structures. Look for opportunities ...
-
API consistency patterns
rocicorp/mono5⭐ 2091Maintain consistent patterns across similar APIs to improve developer experience and reduce cognitive overh...
-
Add missing test coverage
rocicorp/mono5⭐ 2091Identify and address gaps in test coverage by requesting specific tests for untested functionality. When re...
-
Configure CSS layers
mui/material-ui5⭐ 96063When integrating Material UI with other styling solutions like Tailwind CSS v4, proper configuration of CSS...
-
Use semantic naming
mastodon/mastodon5⭐ 48691Choose names that clearly communicate purpose and align with established domain terminology. Prioritize sem...
-
Use contextually descriptive names
mastodon/mastodon5⭐ 48691Names should clearly indicate their purpose and context to avoid confusion, especially when similar concept...
-
Optimize database queries
mastodon/mastodon5⭐ 48691Write efficient database queries by leveraging proper indexes, using performance-optimized ActiveRecord met...
-
early nil validation
mastodon/mastodon5⭐ 48691Check for nil values early in methods and handle them gracefully before they can cause runtime errors or tr...
-
batch similar operations
mastodon/mastodon5⭐ 48691When performing multiple similar operations (database queries, Redis calls, job enqueues, or data lookups),...
-
API parameter design
mastodon/mastodon5⭐ 48691Design API parameters with clear intent, proper validation, and thoughtful default behaviors. Parameter nam...
-
Structure documentation effectively
maplibre/maplibre-native5⭐ 1411Documentation should prioritize clear organization with a logical flow to help developers find information ...
-
Self-documenting code naming
maplibre/maplibre-native5⭐ 1411Method, parameter, and variable names should clearly describe their purpose and behavior, making code self-...
-
Prefer safe null handling
maplibre/maplibre-native5⭐ 1411Use explicit, safe practices when dealing with potentially null resources to prevent memory leaks and undef...
-
Document public API completely
maplibre/maplibre-native5⭐ 1411All public APIs (files in `include/`) must have comprehensive documentation using either Doxygen-style or t...
-
optimize algorithm performance
logseq/logseq5⭐ 37695When implementing algorithms, prioritize performance optimization through careful algorithm selection, quer...
-
Defer expensive operations
logseq/logseq5⭐ 37695Avoid performing expensive computations until they are actually needed, and eliminate redundant work in hot...
-
Configuration option lifecycle
logseq/logseq5⭐ 37695When adding new configuration options, follow a systematic approach to ensure consistency and maintainabili...
-
API parameter consolidation
lobehub/lobe-chat5⭐ 65138When designing API functions with multiple parameters, consolidate optional or related parameters into a si...
-
Eliminate redundant operations
LMCache/LMCache5⭐ 3800Avoid unnecessary function calls, I/O operations, and redundant checks that can significantly impact perfor...
-
Cache state consistency
LMCache/LMCache5⭐ 3800Ensure cache operations maintain consistent state and handle shared resources properly throughout the cache...
-
AI model architecture flexibility
LMCache/LMCache5⭐ 3800Avoid hardcoding AI model-specific assumptions and instead design systems to be configurable across differe...
-
Use descriptive semantic names
llvm/llvm-project5⭐ 33702Choose specific, meaningful names that clearly convey purpose and follow established codebase patterns. Avo...
-
proper error propagation
llvm/llvm-project5⭐ 33702Ensure errors are properly propagated to callers rather than handled locally with exits or fatal errors. Li...
-
minimize header dependencies
llvm/llvm-project5⭐ 33702Organize code to minimize header dependencies and improve compilation times. Use forward declarations inste...
-
Eliminate redundant null checks
llvm/llvm-project5⭐ 33702Avoid unnecessary null checks when the called function already handles null cases, and use references inste...
-
Design thoughtful API interfaces
llvm/llvm-project5⭐ 33702When designing APIs, prioritize clarity, appropriate abstraction levels, and user experience. Avoid magic n...
-
cost-based algorithmic decisions
llvm/llvm-project5⭐ 33702When implementing algorithmic transformations and optimizations, use cost analysis and profitability heuris...
-
use model metadata
ggml-org/llama.cpp5⭐ 83559Leverage model metadata from GGUF format instead of hardcoded configuration values or filename-based logic....
-
optimize memory access patterns
ggml-org/llama.cpp5⭐ 83559Ensure CUDA kernels use optimal memory access patterns to maximize performance. This involves several key p...
-
measure before optimizing
ggml-org/llama.cpp5⭐ 83559Always profile and measure performance impact before implementing optimizations, especially micro-optimizat...
-
AI parameter organization
ggml-org/llama.cpp5⭐ 83559Ensure proper organization and placement of AI model parameters, hyperparameters, and configuration options...
-
Use configuration helper utilities
BerriAI/litellm5⭐ 28310Always use centralized helper functions for configuration management instead of direct environment variable...
-
Prefer generic API patterns
BerriAI/litellm5⭐ 28310Avoid creating provider-specific API implementations when generic, reusable solutions exist or can be devel...
-
background task coordination
BerriAI/litellm5⭐ 28310When working with background tasks in async applications, ensure proper task lifecycle management and coord...
-
avoid expensive operations
BerriAI/litellm5⭐ 28310Identify and optimize resource-intensive operations in frequently executed code paths. This includes avoidi...
-
API parameter consistency
BerriAI/litellm5⭐ 28310Ensure consistent parameter naming, format, and usage across all API interfaces, documentation, and code ex...
-
Validate all inputs
langfuse/langfuse5⭐ 13574All user-controlled inputs must be validated and sanitized before use to prevent injection attacks, unautho...
-
Use structured logging framework
langfuse/langfuse5⭐ 13574Replace all console.* calls with an appropriate structured logging framework using proper log levels. This ...
-
Memoize computed values
langfuse/langfuse5⭐ 13574Cache the results of expensive operations and component renders to avoid redundant calculations during re-r...
-
Ensure deterministic query results
langfuse/langfuse5⭐ 13574Always ensure database queries produce deterministic results by including explicit ORDER BY clauses when us...
-
Avoid array mutations
langfuse/langfuse5⭐ 13574Always clone arrays before performing operations that would mutate the original array, especially when work...
-
intentional error handling
langflow-ai/langflow5⭐ 111046Make deliberate, context-appropriate decisions about error handling strategy rather than applying generic p...
-
Validate untrusted input
langchain-ai/langchainjs5⭐ 15004Always validate and sanitize user-provided inputs before using them in sensitive contexts like SQL queries,...
-
Throw meaningful errors
langchain-ai/langchainjs5⭐ 15004Always throw specific, actionable errors instead of returning unexpected values or simply logging issues. E...
-
Optimize model token usage
langchain-ai/langchainjs5⭐ 15004Implement token-efficient patterns when working with AI models to optimize costs and performance. Key pract...
-
Follow documentation standards
langchain-ai/langchainjs5⭐ 15004Ensure all documentation follows established templates and includes required sections. When referencing com...
-
Prefer early null returns
kubernetes/kubernetes5⭐ 116489Use early return patterns with null checks to reduce nesting and improve code readability. Avoid unnecessar...
-
Optimize search algorithms
kubernetes/kubernetes5⭐ 116489Implement efficient search strategies that minimize computational overhead through proper ordering, early t...
-
Use modern JavaScript idioms
kubeflow/kubeflow5⭐ 15064Favor modern JavaScript syntax and clean code practices to improve readability and maintainability. This in...
-
Structured documentation with examples
kubeflow/kubeflow5⭐ 15064Create comprehensive documentation with clear structure and practical examples. Documentation should includ...
-
Standardize makefile patterns
kubeflow/kubeflow5⭐ 15064Maintain consistent Makefile patterns across all components to improve build reliability and developer expe...
-
Environment variable management
kubeflow/kubeflow5⭐ 15064Manage environment variables in Docker configurations with appropriate scope, placement, and documentation:...
-
Centralize configuration values
kubeflow/kubeflow5⭐ 15064Store all configuration values in dedicated configuration files rather than hardcoding them throughout the ...
-
Consider operation time complexity
JetBrains/kotlin5⭐ 50857When implementing operations that manipulate collections or perform repeated actions, carefully consider th...
-
optimize algorithmic complexity
apache/kafka5⭐ 30575Replace inefficient algorithms with more optimal data structures and approaches to improve computational co...
-
Defensive null validation
apache/kafka5⭐ 30575Always validate null parameters and dependencies early with proper ordering to prevent NullPointerException...
-
API completeness validation
apache/kafka5⭐ 30575Ensure APIs are complete by validating that all necessary cases are handled, all required arguments are pro...
-
Use type-specific variable names
jj-vcs/jj5⭐ 21171Use distinct variable names that reflect their types to avoid confusion and make code intent clearer. Avoid...
-
Consistent naming conventions
jj-vcs/jj5⭐ 21171Maintain consistent naming and terminology throughout code and documentation. This includes proper capitali...
-
eliminate code redundancy
menloresearch/jan5⭐ 37620Remove duplicate imports, unused legacy code, and repetitive patterns to maintain clean, organized codebase...
-
network configuration consistency
istio/istio5⭐ 37192Ensure network-related configurations remain consistent across different components and avoid unintended ov...
-
Conservative networking defaults
istio/istio5⭐ 37192When configuring networking components, prefer stable and permissive defaults over restrictive or experimen...
-
API compatibility preservation
istio/istio5⭐ 37192When evolving APIs, prioritize backward compatibility and avoid changing the semantics of existing fields. ...
-
Structured logging best practices
influxdata/influxdb5⭐ 30268Use structured logging with appropriate field types and context to make logs more useful for troubleshootin...
-
Stable schema identifiers
influxdata/influxdb5⭐ 30268Use persistent identifiers for schema elements rather than relying on positional information or enumeration...
-
Prefer explicit nullability
influxdata/influxdb5⭐ 30268Always make nullable states explicit in your code by leveraging Rust's type system. Use `Option
` rather ... -
Manage complete cache lifecycle
influxdata/influxdb5⭐ 30268Implement comprehensive cache lifecycle management focusing on three key aspects: 1. Idempotent Creation: ...
-
Maintain code readability
influxdata/influxdb5⭐ 30268Ensure code remains readable and maintainable by following these practices: 1. **Combine case statements w...
-
Handle errors by criticality
influxdata/influxdb5⭐ 30268Choose error handling strategies based on operation criticality: 1. For critical operations that could cor...
-
Descriptive semantic naming
influxdata/influxdb5⭐ 30268Create identifiers that clearly convey meaning through descriptive names and appropriate types. Two key pra...
-
Clear configuration parameters
influxdata/influxdb5⭐ 30268Configuration parameters should be descriptively named, well documented, and have sensible defaults that ar...
-
Transactional verified migrations
elie222/inbox-zero5⭐ 8267Enhance database migration reliability by wrapping changes in transactions with pre-check and post-verifica...
-
Time precision matters
elie222/inbox-zero5⭐ 8267When implementing algorithms involving date and time calculations, maintain precise control over time compo...
-
Prevent async race conditions
elie222/inbox-zero5⭐ 8267Always guard against race conditions when working with asynchronous code. Implement these patterns to avoid...
-
Names reflect semantic purpose
elie222/inbox-zero5⭐ 8267Choose names that reflect the semantic purpose rather than implementation details or temporal characteristi...
-
optimize computational efficiency
hyprwm/Hyprland5⭐ 28863Prioritize algorithmic efficiency and avoid unnecessary computational overhead in performance-critical code...
-
reduce nesting complexity
helix-editor/helix5⭐ 39026Prefer code structures that minimize nesting levels and improve readability through early returns, pattern ...
-
Follow established conventions
helix-editor/helix5⭐ 39026Configuration settings should align with official language documentation and established community standard...
-
Standardize observability semantic conventions
grafana/grafana5⭐ 68825When implementing observability features (logs, metrics, traces), use consistent semantic conventions to en...
-
Proper shell quoting
grafana/grafana5⭐ 68825Always use proper quoting in shell scripts (especially GitHub Actions workflows) to prevent word splitting,...
-
Function design principles
grafana/grafana5⭐ 68825Design functions for maximum reusability, clarity, and maintainability. Follow these principles: 1. **Pass...
-
Close resources with errors
grafana/grafana5⭐ 68825Always close resources (files, streams, connections) and properly handle their Close() errors. For read ope...
-
Verify configuration documentation
block/goose5⭐ 19037Ensure all configuration documentation accurately reflects actual system behavior, available options, and c...
-
Use if-unwrap with optionals
ghostty-org/ghostty5⭐ 32864Always use Zig's if-unwrap pattern (`if (optional) |value| {...}`) when working with optional values instea...
-
Use specific configuration patterns
google-gemini/gemini-cli5⭐ 65062When defining exclusion patterns, file filters, or other configuration rules, use specific, targeted patter...
-
Never ignore errors silently
google-gemini/gemini-cli5⭐ 65062All errors must be explicitly handled through catching, logging, or user feedback. Silent error suppression...
-
Maintain naming consistency
google-gemini/gemini-cli5⭐ 65062Ensure consistent naming patterns and approaches across similar functionality in the codebase. This include...
-
implement resource constraints
google-gemini/gemini-cli5⭐ 65062Implement multiple types of resource constraints with appropriate thresholds to prevent performance degrada...
-
document current functionality
google-gemini/gemini-cli5⭐ 65062Documentation should focus exclusively on current, active functionality rather than including historical co...
-
classify errors appropriately
google-gemini/gemini-cli5⭐ 65062Different types of errors require different handling strategies. Classify errors into categories and apply ...
-
Choose efficient data structures
google-gemini/gemini-cli5⭐ 65062Select data structures and algorithms that match your performance requirements rather than defaulting to si...
-
API consistency patterns
google-gemini/gemini-cli5⭐ 65062Maintain consistent interface patterns across APIs and avoid loose coupling through magic strings or unstab...
-
add tests for changes
google-gemini/gemini-cli5⭐ 65062Every code change, whether it's a new feature, bug fix, or refactoring, must include corresponding tests. T...
-
Handle errors completely
fatedier/frp5⭐ 95938Always handle errors comprehensively by checking return values, implementing proper error propagation, and ...
-
Connection lifecycle management
fatedier/frp5⭐ 95938Implement comprehensive lifecycle management for network connections. Ensure proper initialization, authent...
-
Manage dependencies wisely
laravel/framework5⭐ 33763When configuring dependencies in composer.json files, follow these guidelines to ensure maintainable and re...
-
Escape column names properly
laravel/framework5⭐ 33763Always use the appropriate wrapping/escaping mechanism when generating SQL to prevent syntax errors and SQL...
-
Design flexible APIs
laravel/framework5⭐ 33763When designing APIs, prioritize flexibility and developer experience by: 1. **Accept broader parameter typ...
-
Eliminate redundant operations
flutter/flutter5⭐ 172252Identify and remove unnecessary operations that impact performance, including redundant checks, duplicate c...
-
Avoid breaking changes
flutter/flutter5⭐ 172252When modifying existing APIs, prioritize backward compatibility to prevent breaking changes that would forc...
-
Use structured error logging
firecrawl/firecrawl5⭐ 54535Always use the proper logger instance instead of console methods, and format error logs with structured dat...
-
Validate security configurations
gofiber/fiber5⭐ 37560Always verify that security middleware configurations use correct constant values, proper parameter specifi...
-
Evaluate nil check necessity
gofiber/fiber5⭐ 37560Before adding nil checks, evaluate whether they are actually necessary or if they represent false positives...
-
Type-safe API designs
fastify/fastify5⭐ 34000Design APIs with strong type safety to improve developer experience and catch errors at compile time. Avoid...
-
Properly Handle Errors in Fastify Applications
fastify/fastify5⭐ 34000When implementing error handling in Fastify applications, it is important to always throw instances of the ...
-
Preserve error context
fastify/fastify5⭐ 34000When handling errors, always ensure the original error context is preserved and properly surfaced. Error in...
-
Null safe patterns
fastify/fastify5⭐ 34000Use concise null checking patterns to prevent runtime errors and improve code readability when handling pot...
-
Explicit Configuration Usage in Fastify
fastify/fastify5⭐ 34000When using the Fastify framework in TypeScript, ensure that all configuration options are explicitly declar...
-
Consistent JSDoc standards
fastify/fastify5⭐ 34000Document all public APIs and significant internal functions with comprehensive JSDoc comments that include ...
-
Adhere to Fastify Coding Conventions
fastify/fastify5⭐ 34000When implementing code that uses the Fastify package in TypeScript, ensure the following conventions are fo...
-
Protocol-specific error handling
fastapi/fastapi5⭐ 86871Handle errors and responses appropriately based on the network protocol being used. Different protocols hav...
-
Consistent code examples
fastapi/fastapi5⭐ 86871Maintain consistent formatting and styling in code examples throughout your NestJS application documentatio...
-
REST principles first
expressjs/express5⭐ 67300When designing APIs with Express, prioritize proper REST principles and HTTP semantics over convenience. Th...
-
Propagate errors properly
expressjs/express5⭐ 67300Always forward errors to the framework's error handling pipeline instead of swallowing them or handling the...
-
Handle streams properly
expressjs/express5⭐ 67300When transferring data over HTTP, properly implement streaming mechanisms to prevent memory exhaustion and ...
-
Ensure test completion
expressjs/express5⭐ 67300Tests must properly terminate by following appropriate asynchronous patterns. For asynchronous tests, alway...
-
maintain API compatibility
evanw/esbuild5⭐ 39161When implementing or extending APIs, preserve compatibility with existing standards and expected behaviors....
-
Use descriptive consistent names
electron/electron5⭐ 117644Choose names that are both semantically accurate and consistent with established patterns. Names should cle...
-
Descriptive error messages
electron/electron5⭐ 117644Error messages should be descriptive, contextual, and self-identifying to aid debugging and user understand...
-
Prevent redundant operations
elastic/elasticsearch5⭐ 73104In distributed database systems, prevent redundant operations that can overload cluster resources. When imp...
-
validate inputs early
duckdb/duckdb5⭐ 32061Validate function inputs, preconditions, and assumptions as early as possible in the execution flow, prefer...
-
validate inputs comprehensively
duckdb/duckdb5⭐ 32061Ensure thorough input validation and comprehensive edge case handling in database operations. This includes...
-
Optimize algorithm complexity
duckdb/duckdb5⭐ 32061Choose efficient algorithms and data structures to avoid unnecessary computational complexity. Replace manu...
-
consistent null validation
duckdb/duckdb5⭐ 32061Ensure null checks and input validation are applied consistently across similar functions and code paths. W...
-
Test structure and clarity
stanfordnlp/dspy5⭐ 27813Organize tests for maximum clarity and maintainability by leveraging pytest features and proper test struct...
-
reduce nesting levels
stanfordnlp/dspy5⭐ 27813Minimize nested conditional statements and complex control flow by using early returns, guard clauses, and ...
-
prefer nullish coalescing operator
drizzle-team/drizzle-orm5⭐ 29461Use the nullish coalescing operator (`??`) instead of the logical OR operator (`||`) when you specifically ...
-
Version annotation in docs
django/django5⭐ 84182Always include appropriate version annotations when documenting new features or changes in behavior. Use `....
-
Use semantic HTML elements
django/django5⭐ 84182Structure HTML templates using semantically appropriate elements rather than generic containers. Replace no...
-
Structure logs effectively
django/django5⭐ 84182When implementing logging in your application, structure your log messages and parameters consistently to i...
-
Preserve error handling context
django/django5⭐ 84182When handling exceptions, preserve the original error context and provide clear, actionable error messages....
-
Graceful API evolution
django/django5⭐ 84182When evolving APIs, prioritize backward compatibility and provide clear migration paths. For any significan...
-
Comments versus docstrings usage
django/django5⭐ 84182Choose between comments and docstrings based on the documentation's purpose and scope. Use docstrings for A...
-
validate migration data comprehensively
discourse/discourse5⭐ 44898Migration scripts must thoroughly validate data conditions and handle edge cases to ensure reliable data tr...
-
Use modern syntax
discourse/discourse5⭐ 44898Adopt modern JavaScript and Ember syntax patterns instead of legacy approaches to improve code readability ...
-
optimize test fixtures
discourse/discourse5⭐ 44898Use the `fab!` shorthand syntax for creating test fixtures and reuse fabricated objects across tests to imp...
-
Improve code readability
discourse/discourse5⭐ 44898Structure code to match logical flow and extract intermediate variables to improve readability. When dealin...
-
Extract duplicate code
discourse/discourse5⭐ 44898When you notice repeated code patterns, logic blocks, or similar implementations across methods or classes,...
-
simplify complex logic
langgenius/dify5⭐ 114231Improve code readability by reducing complexity and nesting through early returns, extracting complex logic...
-
HTTP standards compliance
langgenius/dify5⭐ 114231Ensure API endpoints follow HTTP standards for status codes and method selection. Delete operations should ...
-
Configuration value types
langgenius/dify5⭐ 114231Ensure configuration values use appropriate types, avoid unnecessary Optional annotations, and maintain con...
-
Use appropriate synchronization mechanisms
denoland/deno5⭐ 103714Select and implement synchronization primitives that match your concurrency requirements and avoid unsafe p...
-
avoid panics gracefully
denoland/deno5⭐ 103714Replace panic-prone operations like `unwrap()` and `expect()` with graceful error handling that provides me...
-
avoid implementation detail leakage
denoland/deno5⭐ 103714APIs should provide clean abstraction boundaries without exposing internal implementation details or creati...
-
User-friendly documentation examples
deeplearning4j/deeplearning4j5⭐ 14036Documentation should guide users toward best practices through clear examples. Begin with positive patterns...
-
Use logging best practices
deeplearning4j/deeplearning4j5⭐ 14036Adopt these logging best practices to ensure consistent, efficient, and meaningful logs: 1. **Use Lombok's...
-
Numerical stability practices
deeplearning4j/deeplearning4j5⭐ 14036When implementing machine learning algorithms, ensure numerical correctness and stability by following thes...
-
Descriptive error context
deeplearning4j/deeplearning4j5⭐ 14036Error messages should be specific, descriptive, and include context to help with debugging. Avoid generic m...
-
Thoughtful error handling
cypress-io/cypress5⭐ 48850Implement error handling that considers recoverability, appropriate logging levels, and prevents redundant ...
-
Simplify complex expressions
cypress-io/cypress5⭐ 48850Break down complex conditional logic, nested structures, and verbose syntax into smaller, well-named functi...
-
prefer modern composition patterns
cypress-io/cypress5⭐ 48850Use Vue 3 Composition API patterns that provide better performance, type safety, and maintainability. Prefe...
-
Explain non-obvious code
cypress-io/cypress5⭐ 48850Add explanatory comments for complex logic, workarounds, and non-obvious code patterns to help future maint...
-
Environment variable validation
cypress-io/cypress5⭐ 48850Always validate environment variables with proper type checking, fallback values, and defensive handling to...
-
consistent descriptive naming
cypress-io/cypress5⭐ 48850Maintain consistent naming patterns across similar functionality while ensuring names accurately describe t...
-
Configuration documentation clarity
cypress-io/cypress5⭐ 48850Ensure configuration documentation, setup instructions, and changelogs use precise, clear language with pro...
-
Model-agnostic AI code
crewaiinc/crewai5⭐ 33945When building applications that interact with AI models, avoid hardcoding model-specific behavior and inste...
-
prefer None over placeholders
home-assistant/core5⭐ 80450When data is unavailable, unknown, or invalid, return `None` instead of placeholder strings like "Unknown",...
-
Minimize try block scope
home-assistant/core5⭐ 80450Only include code that can actually raise exceptions within try blocks. Move variable assignments, logging ...
-
Maintain consistent code style
vuejs/core5⭐ 50769Follow project-wide code style conventions to ensure consistency and readability. Key practices include: 1...
-
Explicit nullish checks
vuejs/core5⭐ 50769When checking for the absence of values, use explicit nullish checks rather than relying on JavaScript's fa...
-
Validate before data access
continuedev/continue5⭐ 27819Always validate data existence and type before accessing properties or methods to prevent runtime errors fr...
-
Standardize AI model interfaces
continuedev/continue5⭐ 27819When implementing AI model integrations, maintain consistent interfaces and proper type definitions across ...
-
Robust comparison algorithms
continuedev/continue5⭐ 27819Ensure your comparison algorithms handle edge cases properly and avoid common pitfalls: 1. **Normalize val...
-
Document why not what
continuedev/continue5⭐ 27819Documentation should explain rationale and be technically precise. Focus on: 1. Including all required par...
-
Decouple tests from implementation
continuedev/continue5⭐ 27819Tests tightly coupled to implementation details break easily when the implementation changes, creating main...
-
Choose clear semantic names
continuedev/continue5⭐ 27819Names should clearly and accurately convey their purpose, behavior, and content. Follow these guidelines: ...
-
Scope concurrency control precisely
docker/compose5⭐ 35858Apply concurrency control mechanisms with precise scope to prevent both race conditions and unnecessary blo...
-
prefer dynamic configuration sources
comfyanonymous/ComfyUI5⭐ 83726Use runtime-determined configuration sources instead of hardcoded values or static file parsing when more r...
-
optimize CI resource usage
comfyanonymous/ComfyUI5⭐ 83726Design CI/CD workflows to minimize unnecessary resource consumption and provide faster feedback. Avoid trig...
-
Explicit error propagation
comfyanonymous/ComfyUI5⭐ 83726Functions should raise exceptions with meaningful messages instead of returning False, None, or silently ca...
-
avoid expensive operations
comfyanonymous/ComfyUI5⭐ 83726Identify and eliminate unnecessary expensive operations that can significantly impact performance. Common p...
-
API backward compatibility
comfyanonymous/ComfyUI5⭐ 83726Ensure API changes maintain backward compatibility to avoid breaking existing clients and workflows. When a...
-
Write comprehensive test assertions
openai/codex5⭐ 31275Instead of making multiple small assertions that check individual fields or conditions, write single compre...
-
Structure configurations properly
openai/codex5⭐ 31275Define a clear, hierarchical structure for application configurations with descriptive naming and proper or...
-
Document non-obvious aspects
openai/codex5⭐ 31275Documentation should explain what isn't obvious from the code itself. Focus on providing context about "why...
-
Contextualize, don't swallow
openai/codex5⭐ 31275Always propagate errors with appropriate context rather than silently ignoring them. This makes debugging e...
-
Centralize configuration management
openai/codex5⭐ 31275Prefer centralized configuration objects over environment variables for application settings. Environment v...
-
use semantic naming
cline/cline5⭐ 48299Choose variable, function, and type names that clearly communicate their purpose and meaning without requir...
-
reuse common message types
cline/cline5⭐ 48299Prefer reusable message types over single-purpose request/response pairs to reduce API bloat and improve ma...
-
centralize configuration management
cline/cline5⭐ 48299Consolidate related configuration settings into dedicated config objects or files rather than scattering ha...
-
Add missing error handling
cline/cline5⭐ 48299Wrap operations that can fail in try/catch blocks to prevent unhandled exceptions from crashing the applica...
-
optimize algorithmic complexity
ClickHouse/ClickHouse5⭐ 42425Always consider the algorithmic complexity and performance implications of data structure choices, memory a...
-
optimize algorithm selection
ClickHouse/ClickHouse5⭐ 42425Choose algorithms and data structures based on actual performance characteristics rather than defaulting to...
-
Extract common patterns
ClickHouse/ClickHouse5⭐ 42425Identify and extract repeated code patterns into reusable functions or methods to improve maintainability a...
-
Database schema consistency
ClickHouse/ClickHouse5⭐ 42425Ensure database operations maintain consistent behavior and ordering, especially in distributed systems. Wh...
-
Use optional chaining
snyk/cli5⭐ 5178Always use optional chaining (`?.`) and null checks when accessing properties or methods on objects that mi...
-
comprehensive test coverage
snyk/cli5⭐ 5178Ensure thorough test coverage by extracting complex logic into small, testable functions and using appropri...
-
Secure credential management
chef/chef5⭐ 7860When handling passwords, certificates, or keys in your code, implement secure encryption and storage mechan...
-
Prefer guard clauses
chef/chef5⭐ 7860Use guard clauses with early returns for null checking instead of wrapping code in conditional blocks. This...
-
Explicit configuration over implicit
chef/chef5⭐ 7860Always define explicit configuration defaults rather than relying on implicit behavior or autovivification....
-
Use appropriate logging levels
bridgecrewio/checkov5⭐ 7668Select the correct logging level based on the importance and visibility requirements of the information. Ch...
-
Thorough test assertions
bridgecrewio/checkov5⭐ 7667Ensure tests thoroughly validate functionality through comprehensive assertions. When writing tests: 1. As...
-
Strategic exception management
bridgecrewio/checkov5⭐ 7668Choose the appropriate error handling strategy based on the context and severity of potential failures. Use...
-
Strategic error handling
bridgecrewio/checkov5⭐ 7667Choose appropriate error handling strategies based on the nature of the error and recovery potential: 1. *...
-
Document configuration options
bridgecrewio/checkov5⭐ 7668Always provide comprehensive documentation for all configuration options, including environment variables, ...
-
Choose optimal data structures
bridgecrewio/checkov5⭐ 7668Select the most appropriate data structure based on the specific operations your algorithm needs to perform...
-
Use descriptive identifiers
calcom/cal.com5⭐ 37732Choose specific, descriptive names for variables, functions, and parameters that clearly communicate their ...
-
Explicit null checks
calcom/cal.com5⭐ 37732Always use explicit null and undefined checks instead of relying solely on optional chaining, especially wh...
-
ensure test reliability
calcom/cal.com5⭐ 37732Write tests that are stable, independent, and non-flaky by following proper isolation and waiting practices...
-
Design contextual API interfaces
calcom/cal.com5⭐ 37732API interfaces should expose only relevant data and functionality based on context, configuration, and user...
-
Use memory pools
oven-sh/bun5⭐ 79093Reuse memory with buffer pools for temporary allocations instead of creating new buffers each time. This re...
-
Network API compatibility
oven-sh/bun5⭐ 79093When implementing networking APIs that mirror Node.js functionality, ensure both behavior and error pattern...
-
Match filenames to contents
oven-sh/bun5⭐ 79093Files should be named to clearly reflect their primary contents: 1. When a file contains a single primary ...
-
Descriptive identifier names
oven-sh/bun5⭐ 79093Choose clear, consistent, and accurate identifiers that precisely reflect behavior and follow established p...
-
Clean all error paths
oven-sh/bun5⭐ 79093Ensure all error paths properly clean up resources and handle errors appropriately. This includes: 1. Usin...
-
Environment variable configuration
browser-use/browser-use5⭐ 69139Prefer environment variables over hardcoded configuration values to improve flexibility and avoid forcing c...
-
Simplify complex code blocks
Homebrew/brew5⭐ 44168Break down complex code blocks and expressions into simpler, more readable components. Complex boolean logi...
-
Actions workflow best practices
Homebrew/brew5⭐ 44168Use GitHub Actions native features and follow best practices to create maintainable, secure, and reliable C...
-
Write clear examples
boto/boto35⭐ 9417Create comprehensive code examples in documentation that demonstrate common operations and use proper forma...
-
Consistent method interfaces
boto/boto35⭐ 9417Design APIs with consistent method interfaces across related resources to improve usability and reduce lear...
-
Configure proxies with schemes
boto/boto35⭐ 9417When configuring proxies in AWS SDK clients, always include the complete URL scheme in proxy definitions. M...
-
Validate before usage
better-auth/better-auth5⭐ 19651Always explicitly check for null or undefined values before using them in operations. Don't assume values e...
-
Prefer simple solutions
better-auth/better-auth5⭐ 19651Choose existing utilities, simpler patterns, and cleaner implementations over manual or complex approaches....
-
Use semantically clear names
bazelbuild/bazel5⭐ 24489Choose names that clearly express their purpose and avoid patterns that can lead to confusion or bugs. Name...
-
Specific exceptions for clarity
Azure/azure-sdk-for-net5⭐ 5809Use specific exception types with meaningful error messages rather than generic exceptions to improve error...
-
Preserve API compatibility
Azure/azure-sdk-for-net5⭐ 5809When evolving APIs, maintain backward compatibility to prevent breaking changes for existing consumers. K...
-
Maintain clean code structure
Azure/azure-sdk-for-net5⭐ 5809Keep code clean and well-organized by: 1. Removing unnecessary elements: - Delete commented-out code tha...
-
Centralize configuration values
Azure/azure-sdk-for-net5⭐ 5809Configuration values should be defined once and referenced throughout your project to ensure consistency an...
-
Prefer descriptive over brief
tokio-rs/axum5⭐ 22100Choose clear, descriptive names over abbreviated or shortened versions. Names should be self-documenting an...
-
Documentation consistency standards
tokio-rs/axum5⭐ 22100Maintain consistent documentation formatting standards across all project files, especially in changelogs, ...
-
Consistent axum Usage in TypeScript
tokio-rs/axum5⭐ 22100When implementing TypeScript code that uses the axum package, maintain consistent and idiomatic usage: alwa...
-
Type-safe API interfaces design
axios/axios5⭐ 107000Design API interfaces with strong type safety while maintaining excellent developer experience. Prefer expl...
-
Standardize null value checks
axios/axios5⭐ 107000Always use consistent patterns and utility functions for handling null and undefined values. This improves ...
-
Specific test assertions
axios/axios5⭐ 107000When writing tests, explicitly assert specific conditions and expected values rather than relying on genera...
-
Proxy protocol handling
axios/axios5⭐ 107000When implementing HTTP clients with proxy support, ensure the connection to the proxy uses the protocol spe...
-
Documentation reflects reality
axios/axios5⭐ 107000Always ensure documentation accurately represents the actual code behavior and implementation details. Incl...
-
Consistent method behaviors
axios/axios5⭐ 107000Design API methods with predictable behavior patterns that follow common conventions. Methods that modify o...
-
Complete error handling chain
axios/axios5⭐ 107000Implement comprehensive error handling throughout the codebase by ensuring all error scenarios are properly...
-
Structured test resource management
aws/aws-sdk-js5⭐ 7628Organize tests with proper resource lifecycle management to ensure reliability and maintainability. Create ...
-
Content integrity verification
aws/aws-sdk-js5⭐ 7628When handling HTTP responses, especially with streaming data, properly verify content integrity and length ...
-
Use descriptive constants
argoproj/argo-cd5⭐ 20149Replace hardcoded strings, numbers, and magic values with well-named constants that clearly describe their ...
-
Use configuration constants
argoproj/argo-cd5⭐ 20149Replace hardcoded values with named constants from common packages or make values configurable through envi...
-
structured logging practices
argoproj/argo-cd5⭐ 20149Use structured logging with proper context and consolidate related log messages. Instead of multiple separa...
-
Provide comprehensive explanations
argoproj/argo-cd5⭐ 20149Documentation should provide thorough technical explanations that define key concepts, explain behaviors, a...
-
Follow Go naming conventions
argoproj/argo-cd5⭐ 20149Adhere to Go naming conventions and maintain consistency with established codebase terminology. This includ...
-
Choose appropriate synchronization primitives
argoproj/argo-cd5⭐ 20149Select the right synchronization mechanism based on your specific use case to avoid performance regressions...
-
Check nil before access
argoproj/argo-cd5⭐ 20149Always verify that pointers and nested struct fields are not nil before accessing their members to prevent ...
-
Assert response fully always
appwrite/appwrite5⭐ 51959Always validate all relevant aspects of API responses in tests, including status codes, headers, and body c...
-
Simplify complex expressions
ant-design/ant-design5⭐ 95882Extract repeated expressions and complex conditional logic into clear, readable variables to improve code m...
-
Semantic naming consistency
ant-design/ant-design5⭐ 95882Choose semantically clear and consistent names across related elements in your codebase. Names should conve...
-
React component API clarity
ant-design/ant-design5⭐ 95882Ensure React component APIs are well-designed with accurate TypeScript interfaces, clear documentation, and...
-
Extract common patterns
ant-design/ant-design5⭐ 95882When you encounter repeated code patterns, conditional logic within loops, or similar implementations acros...
-
Consistent null safety patterns
ant-design/ant-design5⭐ 95882Maintain consistent approaches to null and undefined handling throughout the codebase. Use optional chainin...
-
Configuration documentation standards
ant-design/ant-design5⭐ 95882Ensure configuration properties and settings are documented with consistent formatting and precise specific...
-
avoid redundant operations
angular/angular5⭐ 98611Identify and eliminate redundant computations, function calls, and expensive operations that can be cached,...
-
API consistency patterns
angular/angular5⭐ 98611Ensure that similar APIs follow consistent patterns and conventions across the codebase. When designing or ...
-
AI documentation clarity
angular/angular5⭐ 98611Ensure AI-related documentation, comments, and explanations are clear, accurate, and well-structured. This ...
-
Add explanatory comments
angular/angular5⭐ 98611Code should include explanatory comments when the purpose, behavior, or context is not immediately clear fr...
-
Write audience-appropriate documentation
alacritty/alacritty5⭐ 59675Documentation should be written from the perspective of its intended audience, using language and detail le...
-
prefer early returns
alacritty/alacritty5⭐ 59675Use early returns and guard clauses to reduce nesting levels and improve code readability. When you have mu...
-
Configuration validation feedback
alacritty/alacritty5⭐ 59675Always validate configuration options and provide clear feedback to users about potential issues. This incl...
-
Configuration documentation accuracy
alacritty/alacritty5⭐ 59675Ensure configuration documentation is accurate, consistent, and clearly indicates optional versus required ...
-
Avoid unwrap on nullables
alacritty/alacritty5⭐ 59675Never use `unwrap()` on nullable values that could reasonably be None, as this can cause crashes that are h...
-
avoid unnecessary operations
alacritty/alacritty5⭐ 59675Eliminate redundant work by implementing early returns, avoiding unnecessary clones/references, and skippin...
-
Validate nulls explicitly
apache/airflow5⭐ 40858Always check for null values before using them, and use Python's idiomatic patterns to make these checks co...
-
Use system configuration defaults
apache/airflow5⭐ 40858Always use the configuration system's default values instead of hardcoding defaults in the code. This ensur...
-
Maintain code consistency
apache/airflow5⭐ 40858Ensure consistency throughout the codebase by following established patterns for both UI components and cod...
-
Internationalize ui text
apache/airflow5⭐ 40858All user interface text must be internationalized using the appropriate i18n module instead of hardcoded st...
-
Handle exceptions with specificity
apache/airflow5⭐ 40858Use specific exception types and avoid masking errors through overly broad exception handling or default va...
-
Documentation best practices
apache/airflow5⭐ 40858Documentation should follow established best practices to ensure clarity, consistency, and usefulness: 1. ...
-
Verify properties before logging
vercel/ai5⭐ 15590When logging object properties, always verify that the property names exactly match the actual structure of...
-
Maintain API naming consistency
vercel/ai5⭐ 15590When working with AI model interfaces and result objects, ensure consistent property naming across related ...
-
Document API schemas
vercel/ai5⭐ 15590Add comprehensive JSDoc comments to all API interfaces, types, and schema definitions. This documentation s...
-
Consistent provider options
vercel/ai5⭐ 15590When designing APIs that support multiple providers or service integrations, implement consistent patterns ...
-
Protect render loop performance
zed-industries/zed4⭐ 62119Ensure render loop operations stay within frame time budget (typically 16.67ms for 60fps). Avoid expensive ...
-
Contextualize don't panic
zed-industries/zed4⭐ 62119Always provide meaningful context for errors and avoid code that can panic in production. Use `.context()` ...
-
Background process blocking operations
zed-industries/zed4⭐ 62119Always move potentially blocking operations to background threads to maintain UI responsiveness. Use approp...
-
standardize build configurations
facebook/yoga4⭐ 18255Ensure build configurations are consistently propagated through all build steps and output directories foll...
-
optimize memory layout
facebook/yoga4⭐ 18255Prioritize memory-efficient data structures and algorithms by favoring stack allocation over heap allocatio...
-
Improve code readability
facebook/yoga4⭐ 18255Enhance code clarity and maintainability by applying several readability techniques: extract repeated expre...
-
explicit code declarations
facebook/yoga4⭐ 18255Always make code declarations explicit and consistent to improve readability and maintainability. This incl...
-
Evaluate synchronization necessity
facebook/yoga4⭐ 18255Before implementing thread safety mechanisms like atomic operations or mutexes for global variables, critic...
-
Simplify conditional logic
cloudflare/workers-sdk4⭐ 3379Prefer concise conditional expressions over verbose nested conditions and unnecessary boolean variables. Th...
-
ensure test isolation
cloudflare/workers-sdk4⭐ 3379Tests must be isolated and not leak state between runs. This includes properly cleaning up mocks, spies, an...
-
changeset validation standards
cloudflare/workers-sdk4⭐ 3379Establish comprehensive validation for changesets to ensure reliable release automation. Changesets are req...
-
HTTP protocol compliance
cloudflare/workerd4⭐ 6989Ensure HTTP protocol implementations strictly follow RFC standards and handle edge cases correctly. This in...
-
Connection reuse safety
cloudflare/workerd4⭐ 6989When implementing network connection reuse, prioritize safety over performance by enforcing sequential requ...
-
Add explanatory comments
cloudflare/workerd4⭐ 6989When code behavior, limitations, or implementation decisions are not immediately obvious from reading the c...
-
Validate before expensive operations
microsoft/vscode4⭐ 174887Perform lightweight validation checks before executing expensive operations to avoid unnecessary resource c...
-
Optimize algorithmic complexity first
microsoft/vscode4⭐ 174887When implementing algorithms, prioritize reducing computational complexity before adding special cases or o...
-
Handle configuration value changes
microsoft/vscode4⭐ 174887Configuration values should be properly initialized and stay updated throughout their lifecycle. Follow the...
-
Comprehensive test structure
volcano-sh/volcano4⭐ 4899Tests should focus on comprehensive coverage of main logic flows rather than trivial functions, use establi...
-
Always check errors
volcano-sh/volcano4⭐ 4899Always check and handle errors returned from function calls, especially API operations, before proceeding w...
-
Document AI model capabilities
vllm-project/vllm4⭐ 51730Provide clear, comprehensive documentation for AI model capabilities, especially for multimodal features an...
-
Use parameterized queries
vitessio/vitess4⭐ 19815Always use parameterized queries with bind variables instead of string concatenation or formatting when con...
-
Standardize error wrapping patterns
vitessio/vitess4⭐ 19815Use consistent error wrapping patterns to preserve error context and ensure proper error code propagation. ...
-
Metric design best practices
vitessio/vitess4⭐ 19815Design metrics to be reliable and maintainable by following these key principles: 1. Initialize metrics wi...
-
Log levels and clarity
vitessio/vitess4⭐ 19815Choose appropriate log levels and write clear, meaningful log messages that provide necessary context witho...
-
Explicit nil handling
vitessio/vitess4⭐ 19815Always handle nil values explicitly in your code to improve clarity and prevent subtle bugs. When a functio...
-
Environment-portable configuration management
vitessio/vitess4⭐ 19815Ensure all configurations are environment-portable and follow current best practices for the target platfor...
-
Use optional patterns
vitejs/vite4⭐ 74031Choose the most appropriate pattern for handling potentially undefined or null values. When designing types...
-
Optimize glob operations
vitejs/vite4⭐ 74031When using glob patterns for file system operations, ensure optimal performance and consistent behavior by ...
-
Minimize memory allocations
vitejs/vite4⭐ 74031Choose methods and patterns that reduce unnecessary memory allocations and object creation to improve perfo...
-
Manage configuration inheritance carefully
vitejs/vite4⭐ 74031When designing configuration systems, establish clear default values and inheritance patterns. Follow these...
-
Leverage native tooling
vitejs/vite4⭐ 74031Prioritize native or Rust-based implementations of build tools over their JavaScript counterparts to signif...
-
Evolve APIs with compatibility
vitejs/vite4⭐ 74031When evolving APIs, maintain backwards compatibility while introducing new features by following a staged d...
-
Document code purposefully
vitejs/vite4⭐ 74031High-quality code documentation improves maintainability and helps other developers understand your intenti...
-
Clean configuration organization
vitejs/vite4⭐ 74031Organize configuration settings logically and avoid redundancy in project configuration files. Group relate...
-
Break down complex functions
vitejs/vite4⭐ 74031Improve code readability and maintainability by decomposing large, complex functions into smaller, focused ...
-
explicit null checks
vlang/v4⭐ 36582Always verify that pointers and function return values are not null before dereferencing or using them. Thi...
-
Document algorithm behavior
vlang/v4⭐ 36582When implementing or documenting algorithms, clearly specify their behavior, expected outputs, and usage pa...
-
Configure socket blocking behavior
vlang/v4⭐ 36582Always explicitly configure socket blocking behavior when creating TCP connections, and provide compile-tim...
-
Use direct documentation style
astral-sh/uv4⭐ 60322Write documentation using direct, clear language that addresses the reader directly. Follow these style gui...
-
Respect connectivity state
astral-sh/uv4⭐ 60322Applications should gracefully handle different network connectivity states and provide appropriate feedbac...
-
Consistent authentication patterns
astral-sh/uv4⭐ 60322Design API authentication mechanisms with consistent patterns, clear documentation, and helpful error messa...
-
Balance test performance considerations
astral-sh/uv4⭐ 60322When writing tests, consider both thoroughness and execution time. For operations with significant overhead...
-
optimize algorithmic complexity
Unstructured-IO/unstructured4⭐ 12116When implementing algorithms, prioritize performance by avoiding unnecessary computations and choosing effi...
-
Document configuration reasoning
Unstructured-IO/unstructured4⭐ 12117Always document the reasoning behind configuration decisions, especially for temporary settings like depend...
-
Database schema compliance
Unstructured-IO/unstructured4⭐ 12117Ensure database integrations use correct field names, data types, and schema conventions specific to each d...
-
workspace dependency consistency
unionlabs/union4⭐ 74800All internal project dependencies should use workspace configuration instead of direct path or git referenc...
-
Validate before type conversions
unionlabs/union4⭐ 74800Always validate input constraints and use safe conversion methods before performing type conversions that c...
-
Use structured logging fields
unionlabs/union4⭐ 74800Prefer structured logging fields over string formatting in tracing logs to improve searchability, parsing, ...
-
Effect-based API clients
unionlabs/union4⭐ 74800Use Effect-based HTTP clients with specific error types instead of throwing generic exceptions or relying o...
-
Configuration file completeness
unionlabs/union4⭐ 74800Ensure all configuration files contain required fields, maintain proper structure, and follow consistent fo...
-
API interface design
unionlabs/union4⭐ 74800Design APIs with clean abstractions, logical data organization, and proper layer separation. Structure inte...
-
React rendering safeguards
shadcn-ui/ui4⭐ 90568This standard ensures your React components render correctly and efficiently, preventing common pitfalls th...
-
Provide actionable errors
microsoft/typescript4⭐ 105378Error messages should not only identify problems but also guide developers toward solutions. Include specif...
-
Preserve API compatibility first
microsoft/typescript4⭐ 105378When modifying existing APIs, maintain backwards compatibility by adding new overloads rather than directly...
-
Consistent type algorithms
microsoft/typescript4⭐ 105378Implement consistent algorithms for type compatibility and comparison across different data structures. Whe...
-
Cache expensive computed values
microsoft/typescript4⭐ 105378Cache frequently accessed or computed values to avoid redundant calculations and property lookups. This app...
-
API documentation clarity
astral-sh/ty4⭐ 11919Ensure API documentation, including changelogs and feature descriptions, prioritizes user understanding ove...
-
Validate configuration consistency
twentyhq/twenty4⭐ 35477Ensure configuration values have consistent defaults across all systems and validate configuration structur...
-
Avoid expensive repeated operations
twentyhq/twenty4⭐ 35477Identify and eliminate expensive operations that are performed repeatedly, such as object creation in loops...
-
Keep build tooling updated
vercel/turborepo4⭐ 28115Maintain up-to-date build and CI/CD tooling to leverage the latest features, performance improvements, and ...
-
Define API boundaries
vercel/turborepo4⭐ 28115Clearly specify what constitutes your public API contract to manage versioning expectations and documentati...
-
Configuration precision matters
vercel/turborepo4⭐ 28115Ensure configuration files are precise and stable to prevent unexpected build failures and runtime issues. ...
-
Choose logging levels wisely
vercel/turborepo4⭐ 28115Select appropriate logging levels based on the frequency and importance of the logged operation. Use `trace...
-
Boundary case handling
vercel/turborepo4⭐ 28115Always handle boundary conditions explicitly in algorithms to prevent unexpected behavior. When implementin...
-
validate algorithm boundaries
tree-sitter/tree-sitter4⭐ 21799Always validate boundary conditions and termination criteria in algorithms to prevent infinite loops, out-o...
-
Use meaningful prefixed names
tree-sitter/tree-sitter4⭐ 21799Names should be semantically meaningful and properly prefixed to prevent namespace conflicts. In C, enum va...
-
Simplify conditional logic
tree-sitter/tree-sitter4⭐ 21799Improve code readability by simplifying complex conditional expressions and control flow structures. Factor...
-
Respect environment overrides
tree-sitter/tree-sitter4⭐ 21799Build systems and configuration scripts must respect standard environment variables and provide proper over...
-
Provide clear error context
tree-sitter/tree-sitter4⭐ 21799Always provide meaningful, specific error messages that help users understand what went wrong and why. Use ...
-
parameter type clarity
tree-sitter/tree-sitter4⭐ 21799Design API parameters using specific, intention-revealing types rather than generic or ambiguous ones. This...
-
Optimize CI workflow syntax
tree-sitter/tree-sitter4⭐ 21799Write cleaner and more maintainable CI/CD workflows by following established syntax patterns and best pract...
-
Conditional compilation guards
tree-sitter/tree-sitter4⭐ 21799Always use appropriate preprocessor directives to guard platform-specific, version-dependent, or feature-sp...
-
validate input sanitization
traefik/traefik4⭐ 55772Always maintain input sanitization and validation mechanisms to prevent security vulnerabilities. Disabling...
-
Network information extraction
traefik/traefik4⭐ 55772When extracting network information from connections (such as remote addresses, proxy IPs, or forwarded hea...
-
API interface simplification
traefik/traefik4⭐ 55772Design APIs with clean, minimal interfaces that encapsulate internal logic and avoid exposing unnecessary c...
-
Secure unsafe code
tokio-rs/tokio4⭐ 28989When working with unsafe code, follow these practices to minimize security vulnerabilities: 1. **Minimize ...
-
Optimize algorithmic efficiency
tokio-rs/tokio4⭐ 28981Pay careful attention to operations inside loops and recursive functions to avoid unexpected algorithmic co...
-
Memory ordering needs justification
tokio-rs/tokio4⭐ 28981When using atomic operations, explicitly justify the choice of memory ordering. Each use of a memory orderi...
-
Granular feature flags
tokio-rs/tokio4⭐ 28981Feature flags should be designed with granularity to ensure dependencies are only required when absolutely ...
-
Document null safety assumptions
tokio-rs/tokio4⭐ 28981When writing code that handles potentially null, undefined, or uninitialized values, always document safety...
-
Code block formatting standards
tokio-rs/tokio4⭐ 28981When documenting code examples and shell commands in project documentation, follow these formatting standar...
-
Prefer explicit API design
huggingface/tokenizers4⭐ 9868When designing APIs, favor simple and explicit interfaces over flexible but complex ones. This reduces cogn...
-
Choose semantically clear identifiers
huggingface/tokenizers4⭐ 9868Select parameter and method names that accurately describe their purpose and behavior, avoiding ambiguous t...
-
Choose optimal data structures
huggingface/tokenizers4⭐ 9868Select data structures based on their algorithmic complexity and usage patterns. Consider the tradeoffs bet...
-
Resource cleanup on errors
hashicorp/terraform4⭐ 45532Always ensure proper resource cleanup in error paths to prevent leaks. Use defer functions with explicit er...
-
Explicit protocol interfaces
hashicorp/terraform4⭐ 45532Design protocol interfaces with explicit behavior definitions rather than relying on implicit conventions. ...
-
Ensure test isolation
hashicorp/terraform4⭐ 45532Tests should be completely isolated from each other and clean up after themselves to prevent interference. ...
-
Consistent documentation formatting
hashicorp/terraform4⭐ 45532Maintain consistent style in documentation files to improve readability and professionalism. Specifically: ...
-
Configuration override precedence
hashicorp/terraform4⭐ 45532When designing systems with configurations that can be specified at multiple levels (global vs local, envir...
-
Clarify test documentation
hashicorp/terraform4⭐ 45532Ensure all testing-related documentation is clear, accurate, and user-focused. Use precise terminology when...
-
Choose appropriate API types
hashicorp/terraform4⭐ 45532Select the simplest data types that satisfy requirements when designing API signatures. Avoid using complex...
-
Validate before configuration generation
microsoft/terminal4⭐ 99242Always validate system capabilities and existing configuration state before generating new configuration en...
-
Safe optional handling
microsoft/terminal4⭐ 99242Always use safe patterns when working with optional, nullable, or potentially empty types. Avoid direct com...
-
Safe null handling patterns
microsoft/terminal4⭐ 99242Always use consistent and safe patterns when dealing with potentially null or undefined values. This includ...
-
Reuse defined resources consistently
microsoft/terminal4⭐ 99242Always reuse existing defined constants, resources, and reusable components instead of duplicating values o...
-
Minimize reference counting overhead
microsoft/terminal4⭐ 99242Avoid unnecessary reference counting operations that can impact performance, especially in frequently calle...
-
Implement defensive validation
microsoft/terminal4⭐ 99242Always validate inputs, check boundaries, and avoid relying on undocumented API behavior or assumptions abo...
-
API parameter explicitness
microsoft/terminal4⭐ 99242Always use correct and explicit parameters when calling APIs, rather than relying on defaults or passing in...
-
Tensor-aware control flow
tensorflow/tensorflow4⭐ 190625When working with TensorFlow tensors, avoid using Python comparison operators (`<`, `>=`, `==`) or conditio...
-
Complete docstring structure
tensorflow/tensorflow4⭐ 190625Function documentation should follow a consistent structure that includes all necessary components to be co...
-
Centralize configuration settings
tensorflow/tensorflow4⭐ 190625Place configuration settings in centralized, appropriate locations rather than duplicating them across mult...
-
Trust GetX accessors
temporalio/temporal4⭐ 14953When working with protocol buffer messages or similar objects that provide GetX() accessor methods, avoid r...
-
Safe lock usage patterns
temporalio/temporal4⭐ 14953Follow these critical patterns when using locks to prevent deadlocks, resource leaks, and performance issue...
-
Ensure deterministic execution
temporalio/temporal4⭐ 14953When working with Temporal workflows, maintaining deterministic behavior is critical for reliable replay an...
-
Dynamic config usage principles
temporalio/temporal4⭐ 14953Use dynamic configuration selectively and effectively by following these principles: 1. Only use dynamic c...
-
Consistent naming patterns
temporalio/temporal4⭐ 14953Maintain consistent naming patterns across related components and services. When implementing equivalent fu...
-
Synchronization primitive selection
gravitational/teleport4⭐ 19109Choose appropriate synchronization primitives and ensure proper protection of shared state to avoid race co...
-
prefer simpler patterns
gravitational/teleport4⭐ 19109Choose simpler, more readable code patterns over complex alternatives to improve maintainability and reduce...
-
Optimize computational complexity
gravitational/teleport4⭐ 19109Always analyze the computational complexity of algorithms and choose efficient implementations to avoid per...
-
Authenticated health checks
gravitational/teleport4⭐ 19109When implementing health checks for external services, verify the complete communication stack rather than ...
-
Add contextual logging
gravitational/teleport4⭐ 19109Add informative log messages with sufficient context to help operators diagnose issues, understand system s...
-
Mathematical precision matters
tensorflow/swift4⭐ 6136When implementing mathematical algorithms, ensure precise terminology and correct implementation of mathema...
-
Document environment variables
tensorflow/swift4⭐ 6136When using configurable components, clearly document all relevant environment variables and their effects. ...
-
state boundary management
sveltejs/svelte4⭐ 83580Ensure proper state management when passing reactive values across component and function boundaries. State...
-
Simplify and deduplicate code
sveltejs/svelte4⭐ 83580Write concise, non-redundant code by eliminating unnecessary duplication and using simpler syntax where pos...
-
Documentation clarity standards
sveltejs/svelte4⭐ 83580Ensure technical documentation clearly distinguishes between similar but different concepts, uses precise l...
-
Complete code examples
sveltejs/svelte4⭐ 83580Ensure all code examples are complete, functional, and accurately demonstrate the intended concepts. Code e...
-
API flexibility balance
sveltejs/svelte4⭐ 83580When designing APIs, carefully balance simplicity for common use cases with flexibility for advanced scenar...
-
Secure authentication flows
supabase/supabase4⭐ 86070Design APIs with secure authentication flows by following proper error handling and documentation practices...
-
Protect sensitive API keys
supabase/supabase4⭐ 86070Never expose keys with elevated privileges (such as `service_role` or secret keys) in client-side code. The...
-
Pin dependency versions
supabase/supabase4⭐ 86070Always specify exact versions for dependencies in your configuration files and import statements to ensure ...
-
Maintain network controls
supabase/supabase4⭐ 86070Create maintainable and clearly documented network access controls. Instead of hardcoding network restricti...
-
Maintain code consistency
supabase/supabase4⭐ 86070Ensure consistent code organization, naming conventions, and structure throughout the codebase: 1. Use ide...
-
Handle external operations safely
supabase/supabase4⭐ 86070Always implement explicit error handling for external operations such as network requests, database queries...
-
Follow hooks rules
supabase/supabase4⭐ 86070Adhere strictly to React hooks rules and best practices to ensure your components behave correctly and pred...
-
Document intent clearly
supabase/supabase4⭐ 86070Add clear documentation that explains not just what code does, but why certain approaches were chosen. This...
-
organize code properly
browserbase/stagehand4⭐ 16443Maintain clear code organization by placing code in appropriate files, directories, and modules. Respect mo...
-
API parameter design
browserbase/stagehand4⭐ 16443Design API methods with structured object parameters instead of ordered parameters or loose typing. Use pro...
-
Use environment-independent defaults
spring-projects/spring-framework4⭐ 58382When designing configuration options, avoid relying on environment-specific defaults such as system charact...
-
Spring annotation best practices
spring-projects/spring-framework4⭐ 58382When working with Spring annotations, follow these guidelines to avoid common issues: 1. **Use interface t...
-
Minimize lock contention
spring-projects/spring-framework4⭐ 58382When implementing thread-safe code, minimize the scope and duration of locks to reduce contention and impro...
-
Consistent style conventions
spring-projects/spring-framework4⭐ 58382Apply consistent formatting and organization conventions throughout the codebase to enhance readability and...
-
Explicit security documentation
spring-projects/spring-boot4⭐ 77637Always provide explicit and accurate documentation for security-related configurations, including: 1. Use ...
-
Session-specific configuration access
apache/spark4⭐ 41554Always access configuration through the appropriate session context rather than using global configuration ...
-
self-documenting code practices
apache/spark4⭐ 41554Write code that explains itself through clear structure and meaningful names, while adding targeted comment...
-
Resource cleanup responsibility
apache/spark4⭐ 41554Ensure proper resource management by clearly defining cleanup responsibilities and implementing robust clea...
-
Externalize configuration values
apache/spark4⭐ 41554Avoid hardcoding configuration values directly in code. Instead, make them externally configurable through ...
-
avoid null in Scala
apache/spark4⭐ 41554Avoid using null values in Scala code and prefer Option types for representing optional values. Null usage ...
-
Use existing API utilities
SigNoz/signoz4⭐ 23369Always leverage existing utility hooks, constants, and navigation methods instead of implementing manual so...
-
REST API conventions
SigNoz/signoz4⭐ 23369Follow standard REST API conventions for HTTP methods, status codes, endpoint structure, and response compl...
-
ensure migration idempotency
SigNoz/signoz4⭐ 23369Database migrations must be designed to run safely multiple times without causing errors or data corruption...
-
Avoid inline styles
SigNoz/signoz4⭐ 23369Move all inline styles to dedicated CSS/SCSS files to improve maintainability, consistency, and separation ...
-
Verify algorithmic correctness
sgl-project/sglang4⭐ 17245Ensure algorithmic implementations are correct before applying optimizations or complex conditional logic. ...
-
Use Optional types safely
sgl-project/sglang4⭐ 17245Always use proper nullable type annotations and safe access patterns to prevent runtime errors from null/un...
-
Prevent race conditions
sgl-project/sglang4⭐ 17245Ensure atomic operations and proper synchronization when multiple threads or processes access shared state....
-
Optimize cache performance
sgl-project/sglang4⭐ 17245Prioritize cache performance by leveraging proven optimization techniques and avoiding performance anti-pat...
-
standardize log output methods
serverless/serverless4⭐ 46810Use `process.stdout.write` instead of `console.log` for controlled logging output to avoid linter issues an...
-
Use semantically meaningful names
oraios/serena4⭐ 14465Choose names that clearly convey purpose and intent rather than generic or ambiguous terms. Prefer specific...
-
Use proper logging practices
oraios/serena4⭐ 14465Always use logging instead of print statements, and choose appropriate log levels to avoid log spam. Print ...
-
explicit None handling
oraios/serena4⭐ 14465When operations cannot complete successfully or return meaningful results, explicitly return None rather th...
-
Exception chaining practices
oraios/serena4⭐ 14465Always use exception chaining with `raise ... from e` when re-raising or wrapping exceptions to preserve th...
-
Ensure complete documentation quality
oraios/serena4⭐ 14465Documentation should be comprehensive, clear, and provide all necessary context for understanding and using...
-
Thread management best practices
getsentry/sentry4⭐ 41297When working with threads or thread pools in concurrent code, follow these practices to improve reliability...
-
Raise contextual error types
getsentry/sentry4⭐ 41297Always raise specific, contextual exception types instead of generic exceptions. Include relevant error det...
-
Precise dependency versioning
getsentry/sentry-php4⭐ 1873When specifying dependency version constraints in configuration files, be deliberate about minimum versions...
-
Include practical examples
getsentry/sentry-php4⭐ 1873Enhance technical documentation with clear, practical code examples that demonstrate usage. This applies to...
-
Flexible configuration formats
getsentry/sentry-php4⭐ 1873Support multiple configuration formats where appropriate (string, callable, object) to accommodate differen...
-
Balance CI test coverage
getsentry/sentry-php4⭐ 1873Configure CI workflows to optimize both comprehensive testing and resource usage. For resource-intensive te...
-
Optimize React hook patterns
getsentry/sentry4⭐ 41297Design React hooks with performance and maintainability in mind by following these key principles: 1. Mini...
-
Explicit optional type declarations
getsentry/sentry4⭐ 41297Always explicitly declare optional types in interfaces and function parameters rather than relying on runti...
-
validate environment variable usage
semgrep/semgrep4⭐ 12598Always validate environment variables with proper fallback logic and avoid unnecessary usage in tests or wh...
-
Use appropriate log levels
semgrep/semgrep4⭐ 12598Choose log levels based on the intended audience to prevent user-visible noise. Most logging should use `Lo...
-
Simplify complex logic
semgrep/semgrep4⭐ 12598Break down complex code structures into simpler, more readable forms. Long indented blocks, verbose conditi...
-
Document configuration choices
semgrep/semgrep4⭐ 12598Add explanatory comments for non-obvious configuration settings, especially when they deviate from defaults...
-
Document code purpose
semgrep/semgrep4⭐ 12598Ensure that code elements have clear documentation explaining their purpose, behavior, and context. This in...
-
Design consistent tracing interfaces
semgrep/semgrep4⭐ 12598When implementing observability features like tracing, prioritize consistent and extensible API design. Use...
-
CI workflow optimization
semgrep/semgrep4⭐ 12598Optimize CI/CD workflows by prioritizing reliability over convenience and leveraging built-in platform feat...
-
Benchmark performance assumptions
semgrep/semgrep4⭐ 12598Always validate performance concerns with actual measurements before making optimization decisions. Avoid m...
-
Add CI safety checks
semgrep/semgrep4⭐ 12598Implement defensive checks and error handling in CI/CD workflows to prevent failures and ensure robust oper...
-
Ensure deterministic resume behavior
strands-agents/sdk-python4⭐ 4044When implementing persistence and resume functionality in durable execution systems, ensure that state is p...
-
Extract complex logic helpers
rust-lang/rust4⭐ 105254Complex or duplicated logic should be extracted into well-named helper functions to improve code readabilit...
-
Contextual error messages
rust-lang/rust4⭐ 105254Error messages should provide specific context about the error and guide users toward solutions. When repor...
-
Structure configuration options
dotnet/runtime4⭐ 16578Design and document configuration options (feature flags, environment variables, conditional compilation) t...
-
Maintain consistent formatting
dotnet/runtime4⭐ 16578Ensure consistent formatting and organization throughout the codebase to improve readability and maintainab...
-
Decompose complex algorithms
dotnet/runtime4⭐ 16578When implementing algorithms, break down complex methods that handle multiple concerns into smaller, more f...
-
Choose appropriate error mechanisms
dotnet/runtime4⭐ 16578Use the right error handling mechanism for each scenario: exceptions for recoverable situations, assertions...
-
Support configuration extension patterns
astral-sh/ruff4⭐ 40619When designing configuration systems, provide both replacement and extension options for list-based setting...
-
Maintain focused module structure
astral-sh/ruff4⭐ 40619Keep modules focused and well-organized by grouping related functionality together and splitting large file...
-
Leverage existing API utilities
astral-sh/ruff4⭐ 40619When implementing or consuming APIs, always prefer using existing utility methods and abstractions over man...
-
test real user interactions
TanStack/router4⭐ 11590Write tests that simulate actual user behavior and verify real rendering outcomes rather than testing imple...
-
Maintain backward compatibility
TanStack/router4⭐ 11590When evolving APIs, always maintain backward compatibility to avoid breaking existing user code. Support bo...
-
Ensure documentation clarity
TanStack/router4⭐ 11590Documentation should be clear, accurate, and consistently structured to provide maximum value to developers...
-
API backward compatibility
TanStack/router4⭐ 11590When updating existing APIs, maintain backward compatibility by deprecating old options rather than introdu...
-
Robust error handling
RooCodeInc/Roo-Code4⭐ 17288Implement comprehensive error handling to prevent crashes and aid debugging. This includes: 1. **Use try/c...
-
Prevent unnecessary processing
RooCodeInc/Roo-Code4⭐ 17288Optimize React component performance by minimizing unnecessary operations that can slow down your applicati...
-
Optimize React components
RooCodeInc/Roo-Code4⭐ 17288Apply these React optimization techniques to improve component performance and maintainability: 1. **Use s...
-
Optimize algorithm implementations
RooCodeInc/Roo-Code4⭐ 17288When implementing algorithms, ensure they are both efficient and correct across all input cases. Key consid...
-
Names reflect semantic purpose
RooCodeInc/Roo-Code4⭐ 17288Identifiers (variables, properties, keys, IDs) should accurately reflect their semantic purpose and context...
-
Consistent output path specification
RooCodeInc/Roo-Code4⭐ 17288Configuration files defining operations that generate data outputs must always include a `
` elemen... -
Configuration consistency check
RooCodeInc/Roo-Code4⭐ 17288Ensure that configuration files and settings are consistent with their intended functionality and maintain ...
-
Conditional debug logging
RooCodeInc/Roo-Code4⭐ 17288Remove or conditionally disable console.log and console.debug statements before committing code to producti...
-
model-appropriate configuration
smallcloudai/refact4⭐ 3114Ensure AI models use configuration settings that match their specific architecture and requirements. Differ...
-
Simplify configuration setup
remix-run/react-router4⭐ 55270Avoid redundant configuration parameters and prefer automated solutions over manual maintenance. Remove con...
-
Provide explicit error handling
remix-run/react-router4⭐ 55270Create custom, descriptive errors instead of allowing external dependencies or systems to fail with generic...
-
prefer built-in React types
remix-run/react-router4⭐ 55270Favor React's built-in types over custom interfaces when possible, and consolidate to standard library type...
-
API backward compatibility
remix-run/react-router4⭐ 55270When evolving APIs, maintain backward compatibility by preserving existing public interfaces while adding n...
-
Optimize hot paths
facebook/react4⭐ 237000In performance-critical code paths that execute frequently, optimize to reduce unnecessary operations that ...
-
proper synchronization practices
facebook/react-native4⭐ 123178Ensure thread safety by using appropriate synchronization mechanisms and understanding thread context. When...
-
preserve component patterns
facebook/react-native4⭐ 123178When refactoring React components, maintain essential component patterns including type annotations, ref fo...
-
organize tests clearly
facebook/react-native4⭐ 123178Structure tests with clear organization, focused scope, and minimal duplication to improve maintainability ...
-
optimize algorithmic efficiency
facebook/react-native4⭐ 123178When implementing algorithms, especially in performance-critical paths like scroll handlers or layout metho...
-
minimize public API surface
facebook/react-native4⭐ 123178Carefully evaluate whether functionality needs to be exposed as public API. Keep implementations private wh...
-
Eliminate unnecessary computations
facebook/react-native4⭐ 123178Identify and remove redundant operations, unnecessary copies, and repeated computations that add algorithmi...
-
descriptive specific naming
facebook/react-native4⭐ 123178Use descriptive and specific names that clearly communicate purpose and context. Method names should indica...
-
dependency management strategy
facebook/react-native4⭐ 123178When configuring dependencies in package.json, follow these strategic principles to ensure stable and maint...
-
Avoid synchronous main dispatch
facebook/react-native4⭐ 123178Avoid using `RCTUnsafeExecuteOnMainQueueSync` and similar synchronous main queue dispatch methods as they c...
-
Balance constraints with flexibility
facebook/react4⭐ 237000When designing APIs, carefully evaluate constraints imposed on consumers. Each limitation should serve a cl...
-
Understand query method behavior
rails/rails4⭐ 57027When working with database queries in Active Record, it's essential to understand the precise behavior of q...
-
Optimize cache headers
rails/rails4⭐ 57027Use appropriate HTTP cache headers based on content mutability. For immutable assets (like digest-stamped f...
-
Human-readable configuration values
rails/rails4⭐ 57027When writing configuration files, prioritize human readability and maintainability by using descriptive exp...
-
Efficient data processing
rails/rails4⭐ 57027When implementing algorithms that process large data streams or collections, use a chunking approach rather...
-
Contextual error messages
rails/rails4⭐ 57027Error messages should provide sufficient context to understand and debug the problem efficiently. Include b...
-
Content security policy configuration
rails/rails4⭐ 57027Implement Content Security Policy (CSP) configurations appropriately for your application's context. Use re...
-
Validate database connections explicitly
quarkusio/quarkus4⭐ 14667Always implement explicit database connection validation strategies to ensure robust application behavior d...
-
Secure authentication defaults
quarkusio/quarkus4⭐ 14667Configure authentication mechanisms with secure default settings to prevent security vulnerabilities. When ...
-
Documentation style consistency
quarkusio/quarkus4⭐ 14667Maintain consistent documentation style to improve readability and user experience: 1. **Use precise termi...
-
Avoid wildcard imports
quarkusio/quarkus4⭐ 14667Wildcard (star) imports like `import java.util.*;` are prohibited in the codebase as they reduce code reada...
-
Avoid unnecessary allocations
quarkusio/quarkus4⭐ 14667Minimize object creation and memory allocations, especially in frequently called methods and hot code paths...
-
Automate style enforcement
quarkusio/quarkus4⭐ 14667Implement automated code style enforcement using complementary tools rather than relying on manual reviews....
-
Optimize memory usage
pytorch/pytorch4⭐ 91345Limit memory consumption in performance-critical paths by conditionally creating large data structures or d...
-
Normalize configuration parameters
pytorch/pytorch4⭐ 91345Always normalize configuration inputs (especially environment variables) by removing whitespace and applyin...
-
Eliminate redundant operations
pytorch/pytorch4⭐ 91345Avoid unnecessary operations that can impact performance. This includes: 1. Redundant data transformations...
-
Design for compatibility
pytorch/pytorch4⭐ 91345When evolving APIs, prioritize backward compatibility to minimize disruption for existing users. Add new fu...
-
Choose appropriate exceptions
pytorch/pytorch4⭐ 91345Select the proper exception type based on the error scenario to provide clearer error handling and better d...
-
Write targeted, specific tests
pydantic/pydantic4⭐ 24377Tests should validate specific, well-defined behaviors with clear assertions that directly relate to what's...
-
Simple defaults, flexible overrides
pydantic/pydantic4⭐ 24377Design APIs with intuitive defaults for common use cases while providing specialized options for edge cases...
-
Semantic over syntactic
pydantic/pydantic4⭐ 24377Choose names that clearly communicate the purpose and behavior of your code elements, focusing on semantic ...
-
Safe attribute access pattern
pydantic/pydantic4⭐ 24377Always use safe attribute access patterns to handle potentially null or undefined attributes. Instead of di...
-
Document configuration relationships
pydantic/pydantic4⭐ 24377When designing configuration options that interact with each other, clearly document these relationships an...
-
Consistent configuration patterns
pydantic/pydantic4⭐ 24377When working with configurations in Pydantic models, maintain consistency by using `ConfigDict()` instead o...
-
Balance documentation thoroughness
pydantic/pydantic4⭐ 24377Documentation should balance completeness with avoiding redundancy. When documenting complex features: 1. ...
-
Service layer abstraction
prowler-cloud/prowler4⭐ 11834Separate business logic and external service interactions from API views by using dedicated service layers....
-
Parameterize security commands
prowler-cloud/prowler4⭐ 11834When writing security-related CLI commands or remediation steps, always use standardized parameter placehol...
-
Memory usage optimization
prowler-cloud/prowler4⭐ 11834Optimize memory usage in high-performance applications by implementing explicit memory management technique...
-
Maintain component consistency
prowler-cloud/prowler4⭐ 11834Use a consistent approach when working with components to improve code maintainability and ensure visual co...
-
Ensure migration compatibility
prowler-cloud/prowler4⭐ 11834When modifying database schemas through migrations, ensure compatibility with existing data. For new requir...
-
Document configuration variables
prowler-cloud/prowler4⭐ 11834Always provide complete documentation for configuration variables, including their exact format, purpose, a...
-
Document authentication requirements
prowler-cloud/prowler4⭐ 11834When creating or modifying APIs, always provide comprehensive documentation for authentication methods and ...
-
special value handling
prometheus/prometheus4⭐ 59616Algorithms must explicitly define and consistently handle special values like NaN, infinity, and edge cases...
-
prevent concurrent data races
prometheus/prometheus4⭐ 59616Always analyze shared data access patterns to prevent race conditions in concurrent code. Use appropriate s...
-
maintain API consistency
prometheus/prometheus4⭐ 59616When designing or modifying APIs, ensure they follow established patterns and conventions within the codeba...
-
ensure mathematical correctness
prometheus/prometheus4⭐ 59616When implementing or testing algorithms, ensure mathematical relationships and constraints are maintained t...
-
Configure dependency management comprehensively
prometheus/prometheus4⭐ 59616When configuring dependency management tools like Renovate, ensure comprehensive setup that includes modern...
-
Complete observability documentation
prometheus/prometheus4⭐ 59616Ensure documentation for observability systems provides comprehensive information including all required pe...
-
Check nil at usage
prometheus/prometheus4⭐ 59616Perform null and validity checks at the point where values are actually used, rather than defensively initi...
-
proper async error testing
prisma/prisma4⭐ 42967When testing for expected errors in async code, use Jest's built-in async error testing patterns instead of...
-
Ensure concurrent resource cleanup
prisma/prisma4⭐ 42967Always ensure proper cleanup of concurrent resources like semaphores, transactions, and async operations, e...
-
validate configuration changes
prettier/prettier4⭐ 50772Configuration files require careful validation to ensure they work as intended and don't introduce unintend...
-
Measure performance impacts
prettier/prettier4⭐ 50772Always benchmark and measure actual performance impacts before making optimization decisions, rather than r...
-
maintain API backward compatibility
prettier/prettier4⭐ 50772When evolving public APIs, prioritize backward compatibility and avoid breaking changes to existing interfa...
-
Cache correctness validation
prettier/prettier4⭐ 50772Ensure caching implementations store the correct data and use appropriate strategies for the context. Cache...
-
API documentation clarity
prettier/prettier4⭐ 50772Ensure API documentation provides clear, accurate, and comprehensive information for developers. This inclu...
-
Split complex migrations incrementally
PostHog/posthog4⭐ 28460Break complex schema changes into multiple, sequential migrations to ensure deployment safety and proper da...
-
RESTful endpoint organization
PostHog/posthog4⭐ 28460API endpoints should be properly organized around resources and follow RESTful principles. Avoid placing ag...
-
optimize ORM queries
PostHog/posthog4⭐ 28460Optimize Django ORM queries to prevent performance issues and unnecessary database load. Avoid N+1 query pr...
-
Configuration constants management
PostHog/posthog4⭐ 28460Extract configuration values into well-named constants instead of using magic numbers or inline values. Use...
-
Check existence before operations
PostHog/posthog4⭐ 28460Always verify that keys, IDs, indices, or other required values exist before performing operations that dep...
-
Capture broad exceptions
PostHog/posthog4⭐ 28460When using broad exception handlers like `except Exception:`, always capture and log the exception to avoid...
-
API response standardization
PostHog/posthog4⭐ 28460Ensure API responses follow established patterns and use proper typing. Always use standardized response ty...
-
AI context efficiency
PostHog/posthog4⭐ 28460When providing context to LLMs, choose the most efficient method based on the nature and size of the contex...
-
Prevent deadlock conditions
pola-rs/polars4⭐ 34296Carefully manage resource acquisition and release to prevent deadlocks in concurrent code. Deadlocks typica...
-
Prevent cryptic errors
pola-rs/polars4⭐ 34296Always implement proper validation and type checking to prevent cryptic error messages. When errors do occu...
-
Organize tests efficiently
pola-rs/polars4⭐ 34296Write maintainable, well-structured tests that are easy to understand and extend. Tests should remain simpl...
-
Optimize data transformations
pola-rs/polars4⭐ 34296When implementing data processing operations, avoid unnecessary data transformations, copies, and conversio...
-
Design for operation flexibility
pola-rs/polars4⭐ 34296When implementing algorithms that operate on data structures (particularly arrays, lists, or collections), ...
-
Defer expensive operations
pola-rs/polars4⭐ 34296Avoid triggering expensive computations prematurely in your code. Operations like `collect()`, intensive IO...
-
Choose appropriate abstractions
pola-rs/polars4⭐ 34296When designing APIs, select data types and patterns that match how they will be consumed while facilitating...
-
Use appropriate logging levels
python-poetry/poetry4⭐ 33496Use debug-level logging for technical details and error information that aids developer troubleshooting, wh...
-
Document configuration clearly
python-poetry/poetry4⭐ 33496Configuration files, hooks, and settings should include clear, accurate descriptions that explain their pur...
-
Complete config setting integration
python-poetry/poetry4⭐ 33496When adding new configuration settings, ensure they are properly integrated across all required system comp...
-
Cache expensive computations
python-poetry/poetry4⭐ 33496Identify expensive operations that may be called multiple times and implement appropriate caching mechanism...
-
API backwards compatibility
python-poetry/poetry4⭐ 33496When evolving public APIs, prioritize backwards compatibility through proper deprecation strategies and car...
-
validate algorithmic edge cases
microsoft/playwright4⭐ 76113Algorithms must be thoroughly tested at boundary conditions and edge cases to prevent subtle bugs. Pay spec...
-
testing best practices
microsoft/playwright4⭐ 76113Choose testing methods, configurations, and approaches that prioritize user experience and reliability over...
-
Prioritize documentation clarity
microsoft/playwright4⭐ 76113Documentation should prioritize clarity and actionable guidance over comprehensive coverage. Organize conte...
-
explicit undefined checks
microsoft/playwright4⭐ 76113Always use explicit checks for undefined values and return appropriate nullable types instead of relying on...
-
Avoid redundant operations
microsoft/playwright4⭐ 76113Identify and eliminate duplicate computations, unnecessary object creation, and redundant function calls to...
-
Simplify algorithmic implementations
emcie-co/parlant4⭐ 12205Favor clear, simple algorithmic implementations over complex custom logic. When faced with algorithmic choi...
-
Safe null access patterns
emcie-co/parlant4⭐ 12205Always use safe access patterns to prevent runtime errors when dealing with potentially null or undefined v...
-
safe environment variable access
emcie-co/parlant4⭐ 12205Always use `os.environ.get()` with appropriate defaults instead of direct dictionary access to prevent KeyE...
-
Proper span lifecycle
opentofu/opentofu4⭐ 25901Always ensure trace spans are properly closed in all code execution paths to prevent trace leaks that can d...
-
Prevent backing array surprises
opentofu/opentofu4⭐ 25901When modifying slices in Go, be aware that appending to a slice with available capacity will modify the bac...
-
Minimize API surface
opentofu/opentofu4⭐ 25901Design APIs with minimal exposed surface by encapsulating implementation details within packages. When desi...
-
Write reliable test cases
open-telemetry/opentelemetry-python4⭐ 2061Create deterministic and reliable test cases by following these guidelines: 1. Use hardcoded values instea...
-
Return collections not None
open-telemetry/opentelemetry-python4⭐ 2061Return empty collections (lists, dicts, sets) instead of None when representing empty states. This reduces ...
-
Prevent recursive logging calls
open-telemetry/opentelemetry-python4⭐ 2061Avoid implementing logging calls that could trigger recursive logging patterns, which can lead to infinite ...
-
Precise configuration specifications
open-telemetry/opentelemetry-python4⭐ 2061Ensure configuration files use tool-specific syntax and conventions while leveraging appropriate defaults. ...
-
Place attributes correctly
open-telemetry/opentelemetry-python4⭐ 2061When implementing observability with OpenTelemetry, place attributes at the appropriate level in the teleme...
-
Pin dependency versions
open-telemetry/opentelemetry-python4⭐ 2061Always use exact version pinning (==) for dependencies in requirements files rather than version ranges. Th...
-
Choose data structures wisely
open-telemetry/opentelemetry-python4⭐ 2061Select data structures based on your specific access patterns and performance requirements. Using the right...
-
Use descriptive names
commaai/openpilot4⭐ 58214Choose names that clearly communicate purpose and meaning rather than using abbreviations or unclear terms....
-
Tool-specific configuration compatibility
commaai/openpilot4⭐ 58214When working with configuration files that support multiple tools or package managers, ensure that configur...
-
Prefer asynchronous operations
commaai/openpilot4⭐ 58214Use asynchronous patterns to prevent blocking operations from degrading system performance, especially in U...
-
optimize data structure selection
commaai/openpilot4⭐ 58214Choose data structures and algorithms based on their computational complexity and access patterns rather th...
-
Initialize and validate values
commaai/openpilot4⭐ 58214Always initialize variables with sensible default values and validate inputs to prevent null reference erro...
-
Be specific with exceptions
commaai/openpilot4⭐ 58214Avoid catching broad exception types like `Exception` and instead catch specific exceptions that you expect...
-
prefer built-in error utilities
opengrep/opengrep4⭐ 1546Use existing error handling utilities and appropriate error mechanisms instead of implementing manual error...
-
Optimize for common cases
opencv/opencv4⭐ 82865When implementing algorithms, create specialized versions for common cases to improve performance, while ma...
-
Framework synchronization practices
opencv/opencv4⭐ 82865When implementing concurrent code, always use the framework's provided synchronization primitives rather th...
-
Document properly with references
opencv/opencv4⭐ 82865Always separate code from documentation and use proper referencing techniques. Documentation should be in m...
-
Reuse buffers strategically
ollama/ollama4⭐ 145704For frequently called methods or hot code paths, reuse allocations instead of creating new buffers on each ...
-
Platform-aware configuration documentation
ollama/ollama4⭐ 145705Always document platform-specific configuration differences and requirements thoroughly. When writing docum...
-
Loose API coupling
ollama/ollama4⭐ 145704Maintain a clear separation between API definitions and their implementations by avoiding direct passing of...
-
Use async/await pattern
octokit/octokit.net4⭐ 2793When designing or documenting API clients, always use the async/await pattern rather than blocking calls. R...
-
Catch specific exceptions
octokit/octokit.net4⭐ 2793Always catch specific exception types rather than using general catch blocks. This improves error handling ...
-
robust algorithm implementation
nrwl/nx4⭐ 27518Implement algorithms that handle edge cases and avoid brittle assumptions about input data or structure for...
-
Ensure configuration consistency
nrwl/nx4⭐ 27518Configuration files should maintain consistency in patterns, use correct paths and values, and follow estab...
-
Documentation metadata consistency
nrwl/nx4⭐ 27518Ensure documentation uses consistent structural elements and proper metadata to optimize user experience an...
-
Configuration documentation clarity
nrwl/nx4⭐ 27518Configuration changes and examples should be documented with clear formatting, proper context, and helpful ...
-
Vue context boundaries
nuxt/nuxt4⭐ 57769Ensure Vue composables, reactive state, and side effects are properly scoped within Vue's execution context...
-
Strategic component loading
nuxt/nuxt4⭐ 57769Choose component loading strategies based on when interactivity is actually needed, not just code splitting...
-
optimize array operations
nuxt/nuxt4⭐ 57769Pre-allocate arrays when the final size is known and consolidate multiple iterations into single loops to r...
-
Handle async cancellation properly
nuxt/nuxt4⭐ 57769When implementing async operations with cancellation support, ensure that cancelled operations do not conti...
-
Cache lifecycle management
nuxt/nuxt4⭐ 57769Implement comprehensive cache lifecycle management that includes proper key management, invalidation strate...
-
Optimize collection operations
novuhq/novu4⭐ 37700When processing collections of data, choose efficient algorithms and data structures that minimize computat...
-
Environment-aware feature gating
novuhq/novu4⭐ 37700Always check environment variables, deployment modes, subscription tiers, and feature flags before enabling...
-
Limit environment variable scope
nodejs/node4⭐ 112178When working with environment variables for configuration: 1. **Reuse existing environment variables** rat...
-
Format docs for readability
nodejs/node4⭐ 112178Documentation should follow consistent formatting and structural patterns to maximize readability and maint...
-
Follow naming conventions
nodejs/node4⭐ 112178Maintain consistent naming conventions across the codebase: - Use PascalCase for class methods (e.g., `All...
-
Document non-intuitive code
nodejs/node4⭐ 112178Add clear comments to explain complex logic, function differences, and non-obvious implementation details. ...
-
Descriptive function names
nodejs/node4⭐ 112178Function and method names should precisely describe their purpose and behavior. Choose names that explicitl...
-
Await all promises
nodejs/node4⭐ 112178Always explicitly await all asynchronous operations, especially in cleanup code paths and resource manageme...
-
Verify documentation references
vercel/next.js4⭐ 133000When writing or updating documentation, ensure all code examples, installation commands, and project refere...
-
Proper Use of Suspense in Next.js Components
vercel/next.js4⭐ 133000When building Next.js applications that leverage server-side rendering (SSR) or Partial Prerendering (PPR),...
-
Proper Error Handling in Next.js API Routes
vercel/next.js4⭐ 133000This review focuses on ensuring proper error handling in Next.js API routes. Key principles include validat...
-
Maintain Consistent Naming Conventions in Next.js Code
vercel/next.js4⭐ 133000As a code reviewer for Next.js projects, ensure that all code artifacts, including component names, file na...
-
Dynamic API behavior detection
ChatGPTNextWeb/NextChat4⭐ 85721APIs should determine behavior based on runtime request characteristics rather than static configuration fl...
-
Protect network buffer lifecycle
netty/netty4⭐ 34227When handling network buffers in protocol implementations, ensure proper lifecycle management to prevent me...
-
Preserve backward compatibility
netty/netty4⭐ 34227When evolving APIs in minor versions, always maintain backward compatibility to avoid breaking client code....
-
Optimize search operations
netty/netty4⭐ 34227Enhance search algorithm performance by prioritizing common cases, using appropriate data structures, and a...
-
Configurable over hardcoded
netty/netty4⭐ 34227Make configuration parameters configurable rather than hardcoding values, especially for limits, sizes, and...
-
Use consistent control structures
nestjs/nest4⭐ 71766Always use curly braces for control structures (if, for, while, etc.), even for single-line statements. Thi...
-
Structure exception handling patterns
nestjs/nest4⭐ 71766Implement consistent exception handling using framework-provided mechanisms rather than ad-hoc try-catch bl...
-
Standardize logger configuration patterns
nestjs/nest4⭐ 71766Maintain consistent logger configuration and usage patterns across the application while leveraging built-i...
-
Prevent async race conditions
nestjs/nest4⭐ 71767Design async operations to prevent race conditions, memory leaks, and ensure proper resource cleanup. Key p...
-
Pin dependency versions
nestjs/nest4⭐ 71766Explicitly pin or constrain dependency versions in CI/CD configurations instead of using `latest` tags. Thi...
-
Package dependency configuration
nestjs/nest4⭐ 71767Configure dependencies appropriately in package.json based on usage patterns and requirements. This improve...
-
HTTP header management
nestjs/nest4⭐ 71766When working with HTTP responses, follow these principles for proper header management: 1. **Only set defa...
-
Document configuration behaviors
nestjs/nest4⭐ 71766Always document configuration options thoroughly, especially for module and service settings. For each conf...
-
Configurable log formatting
nestjs/nest4⭐ 71767Design logging systems with customizable formatting and output options. Separate formatting logic into prot...
-
Benchmark before optimizing
nestjs/nest4⭐ 71766When making performance-critical decisions, always validate your approach with benchmarks using realistic d...
-
Use descriptive names
neovim/neovim4⭐ 91433Avoid ambiguous or vague identifiers in favor of specific, self-documenting names that clearly convey purpo...
-
Semantic naming over implementation
neovim/neovim4⭐ 91433Choose names that reflect the semantic purpose and meaning rather than implementation details or internal m...
-
Initialize before dereferencing
neovim/neovim4⭐ 91433Always ensure buffers, containers, and data structures are properly initialized before passing them to func...
-
consolidate network APIs
neovim/neovim4⭐ 91433When implementing network functionality, consolidate around standardized APIs like `vim.net.request()` inst...
-
Configuration variable organization
neovim/neovim4⭐ 91433Use structured naming patterns and avoid polluting the global namespace when managing configuration variabl...
-
Conditional expensive operations
neovim/neovim4⭐ 91433Only execute expensive operations when they are actually necessary. Avoid paying performance costs for func...
-
avoid unnecessary configuration
neovim/neovim4⭐ 91433Avoid creating special-purpose configuration options when simpler alternatives exist. Don't force users to ...
-
avoid error masking
neovim/neovim4⭐ 91433Don't use mechanisms that suppress or hide errors unless absolutely necessary for the application flow. Err...
-
Scope JWT authentication tokens
neondatabase/neon4⭐ 19015Always include tenant, timeline, and endpoint identifiers in JWT tokens used for service authentication. Th...
-
Proper Option type usage
neondatabase/neon4⭐ 19015Use Option
only for truly optional values that can meaningfully be None. Avoid using Option when a value... -
Proactive cache warming
neondatabase/neon4⭐ 19015Implement proactive cache warming strategies to minimize performance degradation after system restarts or d...
-
Pin GitHub action versions
neondatabase/neon4⭐ 19015Always pin GitHub Actions to specific commit hashes instead of using major/minor version tags (like @v4). T...
-
Ensure algorithm robustness
neondatabase/neon4⭐ 19015When implementing algorithms, ensure they handle all edge cases correctly and robustly. Code should gracefu...
-
Connection pooling with pipelining
neondatabase/neon4⭐ 19015Implement connection pooling with request pipelining for network services to optimize resource usage and im...
-
Secure credential data handling
n8n-io/n8n4⭐ 122978Always protect sensitive credential data through proper encryption, secure storage, and careful handling in...
-
Maintain semantic naming consistency
n8n-io/n8n4⭐ 122978Names should be semantically meaningful and consistent across related concepts in the codebase. This applie...
-
Explicit environment configuration handling
n8n-io/n8n4⭐ 122978Environment and configuration values should be explicit, visible, and environment-aware. Avoid hardcoded pr...
-
Descriptive parameter names
n8n-io/n8n4⭐ 122978Use specific, descriptive parameter names for API resources rather than generic identifiers. Parameter name...
-
Consistent naming patterns
n8n-io/n8n4⭐ 122978Maintain consistent naming conventions throughout the codebase to improve readability and maintainability. ...
-
Consistent identifier naming
n8n-io/n8n4⭐ 122978Follow consistent naming conventions for all identifiers to improve code quality, accessibility, and test r...
-
Configuration consistency management
n8n-io/n8n4⭐ 122978When modifying configuration files, ensure all references to the changed values are updated consistently ac...
-
Actions configuration best practices
n8n-io/n8n4⭐ 122978When working with GitHub Actions workflows, follow these configuration best practices: 1. **Boolean inputs...
-
Graph traversal optimization
apache/mxnet4⭐ 20801When working with graph structures, avoid performing redundant depth-first search (DFS) traversals as each ...
-
Explicit null checks
apache/mxnet4⭐ 20801Always use explicit null checks (`value is None` or `value is not None`) rather than implicit truthiness ev...
-
Comprehensive API documentation
apache/mxnet4⭐ 20801Ensure all API elements are thoroughly documented following a consistent format. This includes: 1. **All f...
-
Avoid redundant calculations
apache/mxnet4⭐ 20801Eliminate redundant calculations by identifying and caching frequently used values to improve performance. ...
-
WebSocket lifecycle management
rocicorp/mono4⭐ 2091Ensure proper WebSocket connection lifecycle management by using `once()` instead of `on()` for cleanup ope...
-
verify authorization before operations
rocicorp/mono4⭐ 2091Always verify that users have proper authorization to access and modify resources before performing any dat...
-
dependency management practices
rocicorp/mono4⭐ 2091Ensure comprehensive dependency management in package.json files by following these practices: 1. **Evalua...
-
Write user-centric documentation guides
mui/material-ui4⭐ 96063Documentation should be written with the user's perspective in mind, using clear, action-oriented language ...
-
Use slots for composition
mui/material-ui4⭐ 96063When designing React component APIs, implement the slots pattern using `slots` and `slotProps` props instea...
-
Test behavior not implementation
mui/material-ui4⭐ 96063Focus tests on user behavior and outcomes rather than implementation details. Structure tests to simulate r...
-
Strict mode-proof hooks
mui/material-ui4⭐ 96063Ensure your React components work correctly in both development (Strict Mode) and production environments b...
-
Standardize code formatting patterns
mui/material-ui4⭐ 96063Maintain consistent code formatting patterns across the codebase to improve readability and maintainability...
-
Standardize build configurations
mui/material-ui4⭐ 96063When configuring module builds, maintain consistent and explicit configuration for different module formats...
-
Semantic descriptive naming
mui/material-ui4⭐ 96063Choose names that clearly communicate purpose, behavior, and semantics of code elements. Names should be se...
-
Explicit configuration specifications
mui/material-ui4⭐ 96063When writing configuration files, be explicit and precise about dependencies and versions rather than using...
-
Event-triggered network requests
mui/material-ui4⭐ 96063When implementing user interactions that trigger network requests, use precise event handling techniques to...
-
Document compatibility boundaries
mui/material-ui4⭐ 96063Clearly communicate your API's compatibility guarantees and limitations. When designing APIs, explicitly in...
-
Distinguish Next.js routers
mui/material-ui4⭐ 96063Always provide separate implementation instructions for Next.js App Router (13+) and Pages Router. These ro...
-
Avoid render cycle allocations
mui/material-ui4⭐ 96063Creating new objects, arrays, or functions inside a component's render cycle causes unnecessary allocations...
-
Use accessible terminology
mastodon/mastodon4⭐ 48691Choose clear, understandable names and terminology that are appropriate for your intended audience, avoidin...
-
prefer early returns
mastodon/mastodon4⭐ 48691Use early returns and guard clauses to reduce nested conditionals and improve code readability. This patter...
-
optimize test organization
mastodon/mastodon4⭐ 48691Organize tests to minimize factory creation, reduce duplication, and improve performance by chaining assert...
-
migration data dependencies
mastodon/mastodon4⭐ 48691Ensure that migrations properly handle data dependencies and sequencing to prevent deployment failures. Whe...
-
Hook responsibility separation
mastodon/mastodon4⭐ 48691Keep hooks and components focused on single, well-defined responsibilities to maintain clean architecture a...
-
explicit API parameters
microsoft/markitdown4⭐ 76602Make API parameters explicit and named rather than hiding them in **kwargs. This improves clarity, enables ...
-
Use proper logging
maplibre/maplibre-native4⭐ 1411Always use the project's standard logging system (mbgl::Log) with appropriate log levels instead of ad-hoc ...
-
Structured coroutine management
maplibre/maplibre-native4⭐ 1411Always bind coroutine scopes to appropriate lifecycles and follow consistent patterns for asynchronous oper...
-
Preallocate collection capacity
maplibre/maplibre-native4⭐ 1411When the final size of a collection is known before adding elements, use `reserve()` to preallocate memory ...
-
Extract workflow scripts
maplibre/maplibre-native4⭐ 1411Move complex scripts out of workflow YAML files into separate, dedicated script files in your repository. T...
-
Enforce clear data ownership
maplibre/maplibre-native4⭐ 1411Always establish and maintain clear ownership semantics in concurrent code to prevent data races. This incl...
-
Document platform requirements
maplibre/maplibre-native4⭐ 1411When setting or changing minimum platform version requirements, always document the specific technical reas...
-
Descriptive named constants
maplibre/maplibre-native4⭐ 1411Replace magic numbers and unclear variables with descriptive named constants using appropriate naming conve...
-
Configure platform-specific builds
maplibre/maplibre-native4⭐ 1411Ensure build and distribution configurations are properly documented and optimized for each target platform...
-
Separate user system data
logseq/logseq4⭐ 37695Separate user-facing data from system/implementation data using proper namespacing and schema design to pre...
-
Fail fast explicitly
logseq/logseq4⭐ 37695When critical components or operations fail, throw explicit errors rather than silently continuing or retur...
-
Use reactive hooks
lobehub/lobe-chat4⭐ 65138Always use React's reactive hook patterns instead of imperative state access or manual effect management. T...
-
Use idempotent migrations
lobehub/lobe-chat4⭐ 65138Always use defensive programming patterns in migration scripts to ensure they can be executed multiple time...
-
Provider-based interface design
lobehub/lobe-chat4⭐ 65138When designing interfaces that handle multiple providers or services, organize the API structure around pro...
-
Explicit environment declarations
lobehub/lobe-chat4⭐ 65138Always explicitly declare environment variables in configuration files, even when they have default values....
-
CSS utility usage
lobehub/lobe-chat4⭐ 65138Use CSS utility functions and avoid complex inline calculations for better maintainability and readability....
-
Maintain comprehensive error handling
LMCache/LMCache4⭐ 3800Always preserve and implement thorough error handling that includes proper resource cleanup, meaningful log...
-
Configuration validation standards
LMCache/LMCache4⭐ 3800Ensure configuration parameters follow consistent validation, naming, and default value standards to improv...
-
optimize computational complexity
llvm/llvm-project4⭐ 33702When implementing algorithms, be mindful of computational complexity and optimize for efficiency by avoidin...
-
Configuration completeness validation
llvm/llvm-project4⭐ 33702Ensure configuration options are complete and properly validated before use. When implementing configuratio...
-
validate bounds before access
ggml-org/llama.cpp4⭐ 83559Always validate array indices, buffer sizes, and container bounds before accessing elements to prevent out-...
-
prioritize compile-time optimizations
ggml-org/llama.cpp4⭐ 83559In performance-critical code, favor compile-time optimizations over runtime flexibility to enable better co...
-
maintain code consistency
ggml-org/llama.cpp4⭐ 83559Always follow the existing code style patterns and conventions found in the surrounding codebase rather tha...
-
API minimalism principle
ggml-org/llama.cpp4⭐ 83559Keep APIs minimal by avoiding redundant interfaces and preferring simple solutions over complex ones. When ...
-
Safe operations with fallbacks
BerriAI/litellm4⭐ 28310Implement defensive programming by wrapping potentially failing operations in safe methods that provide fal...
-
Prevent flaky test timing
langfuse/langfuse4⭐ 13574Replace non-deterministic timing patterns with reliable alternatives to prevent flaky tests. This includes:...
-
Pin dependency versions
langfuse/langfuse4⭐ 13574Always pin external dependencies to specific versions in CI/CD workflows to ensure build reproducibility, s...
-
Explicit null value checks
langfuse/langfuse4⭐ 13574Use explicit null/undefined checks instead of truthy/falsy checks when handling potentially null or undefin...
-
Configuration value consistency
langfuse/langfuse4⭐ 13574Maintain consistency in configuration values across the application by following these practices: 1. **Use...
-
Prevent code injection vulnerabilities
langflow-ai/langflow4⭐ 111046When evaluating user-provided code or handling dynamic content, implement strict security measures to preve...
-
Database configuration clarity
langflow-ai/langflow4⭐ 111046When documenting database configuration or setup procedures, provide specific, actionable instructions with...
-
Avoid hardcoded configuration values
langflow-ai/langflow4⭐ 111046Replace hardcoded configuration values with configurable parameters to improve flexibility and maintainabil...
-
AI response variability
langflow-ai/langflow4⭐ 111046When documenting AI model interactions, account for the non-deterministic nature of AI responses and avoid ...
-
AI model chunk sizing
langflow-ai/langflow4⭐ 111046When configuring text processing components that work with AI embedding models, proactively consider tokeni...
-
Use database-native types
langchain-ai/langchainjs4⭐ 15004Always leverage database-native data types and appropriate schema design to maximize performance and query ...
-
Eliminate redundant code
langchain-ai/langchainjs4⭐ 15004Simplify code by eliminating redundancy and unnecessary complexity. This improves readability, reduces pote...
-
Dependency classification standards
langchain-ai/langchainjs4⭐ 15004Properly classify dependencies in package.json according to their usage pattern and project guidelines. Thi...
-
Comprehensive AI documentation
langchain-ai/langchainjs4⭐ 15004When documenting AI integrations, provide comprehensive examples that showcase all common initialization an...
-
Avoid hardcoded configurations
langchain-ai/langchainjs4⭐ 15004Always parameterize values that might vary across different environments or users instead of hardcoding the...
-
Wrap errors meaningfully
kubernetes/kubernetes4⭐ 116489Always wrap errors with meaningful context that explains what operation failed and why. Use proper error wr...
-
Prevent information disclosure
kubernetes/kubernetes4⭐ 116489Avoid exposing sensitive information through error messages, logs, configuration, or other output channels ...
-
Feature gate configuration management
kubernetes/kubernetes4⭐ 116489Ensure feature gates are properly managed across all configuration files and contexts. Feature-specific per...
-
Standardize network tools
kubeflow/kubeflow4⭐ 15064When performing network operations in build scripts or containers, prefer `curl` over `wget` for HTTP reque...
-
Prioritize readability over brevity
kubeflow/kubeflow4⭐ 15064When writing code, favor readability and maintainability over clever or compact solutions. Break down compl...
-
Pin version dependencies
kubeflow/kubeflow4⭐ 15064Explicitly pin version dependencies in configuration files to ensure reproducible builds and prevent breaki...
-
Load configurations efficiently
kubeflow/kubeflow4⭐ 15064When designing components that require configuration, follow these practices to enhance performance, mainta...
-
Follow API conventions
kubeflow/kubeflow4⭐ 15064When designing APIs, adhere to established API conventions, particularly Kubernetes API conventions when wo...
-
Externalize configuration parameters
kubeflow/kubeflow4⭐ 15064Create configurations that can be easily managed outside your application code. Design configuration parame...
-
Document code thoroughly
kubeflow/kubeflow4⭐ 15064Always include appropriate documentation in your code to improve readability, maintainability, and usabilit...
-
Contextualize and classify errors
kubeflow/kubeflow4⭐ 15064Always provide meaningful context when handling errors, and classify them appropriately based on their sour...
-
Centralize configuration constants
kubeflow/kubeflow4⭐ 15064Store configuration constants, defaults, and environment variable mappings in dedicated configuration files...
-
Use defensive null checks
JetBrains/kotlin4⭐ 50857When working with properties or methods that could potentially be null, use Kotlin's null safety features d...
-
minimize merge conflicts
kilo-org/kilocode4⭐ 7302When working with upstream codebases, prioritize coding approaches that minimize merge conflicts while main...
-
validate configuration dependencies
apache/kafka4⭐ 30575Validate configuration dependencies and constraints at initialization time rather than allowing invalid com...
-
optimize data structures
apache/kafka4⭐ 30575When working with data structures and collections, optimize for performance and correctness by using modern...
-
Optimize collection conversions
apache/kafka4⭐ 30575When converting between Java and Scala collections or performing set operations, choose methods that minimi...
-
Improve code readability
apache/kafka4⭐ 30575Write code that prioritizes readability through clear string formatting, descriptive method calls, and well...
-
Ensure complete JavaDoc coverage
apache/kafka4⭐ 30575All public classes, methods, and parameters must have comprehensive JavaDoc documentation. This includes: ...
-
catch specific exceptions
apache/kafka4⭐ 30575Avoid catching overly broad exception types like `Throwable` or `Exception` when you can be more specific a...
-
preserve error context
jj-vcs/jj4⭐ 21171When handling errors, preserve the original error context and avoid exposing internal representations to us...
-
Minimize API scope
jj-vcs/jj4⭐ 21171When designing APIs, prioritize simplicity and focused scope over feature completeness. Before adding new A...
-
Use configuration constants
menloresearch/jan4⭐ 37620Always use named constants, enums, or well-defined configuration objects instead of magic strings, numbers,...
-
model description accuracy
menloresearch/jan4⭐ 37620Ensure AI model descriptions are specific, capability-focused, and avoid marketing language or temporal ref...
-
Implement graceful error fallbacks
menloresearch/jan4⭐ 37620Always implement fallback mechanisms when primary operations can fail, especially for critical operations l...
-
Document AI infrastructure requirements
menloresearch/jan4⭐ 37620When documenting AI applications that run local models or perform inference, always provide comprehensive i...
-
Cross-platform configuration simplification
menloresearch/jan4⭐ 37620When writing configuration files and scripts, prioritize cross-platform compatibility while keeping configu...
-
AI model configuration completeness
menloresearch/jan4⭐ 37620Ensure all necessary AI model parameters are properly configured and passed through the system. AI models r...
-
AI accuracy documentation
menloresearch/jan4⭐ 37620Ensure accurate representation of AI model capabilities, proper attribution, and honest claims about functi...
-
telemetry consistency standards
istio/istio4⭐ 37192Ensure telemetry attribute population logic is consistent across all components and follows established sta...
-
Document observability rationale
istio/istio4⭐ 37192When introducing, modifying, or removing observability features (tracing, metrics, monitoring configuration...
-
API version compatibility first
istio/istio4⭐ 37192When selecting API versions, prioritize compatibility over using the latest available version. Choose older...
-
prefer idiomatic patterns
vadimdemedes/ink4⭐ 31825Choose language-native methods and control structures that make code more readable and maintainable. Use bu...
-
Package.json configuration standards
vadimdemedes/ink4⭐ 31825Ensure package.json follows modern standards and maintains consistency across configuration fields. Use str...
-
avoid `any` type usage
vadimdemedes/ink4⭐ 31825Replace `any` type annotations with more specific types to improve type safety and null handling. The `any`...
-
Use structured logging fields
influxdata/influxdb4⭐ 30268Always use structured logging with descriptive field names rather than string interpolation. Include releva...
-
Prevent nil dereferences
influxdata/influxdb4⭐ 30268Always verify that pointers, slices, or arrays are non-nil and have sufficient elements before attempting t...
-
Prefer configurable values
influxdata/influxdb4⭐ 30268Always use configurable values instead of hardcoded defaults when available. This ensures that user prefere...
-
Performance-conscious metrics implementation
influxdata/influxdb4⭐ 30268Implement metrics collection that is both comprehensive and minimally impactful on system performance. Desi...
-
Include explanatory examples
influxdata/influxdb4⭐ 30268Always enhance documentation with concrete, illustrative examples that demonstrate expected inputs, formats...
-
Avoid unnecessary work
influxdata/influxdb4⭐ 30268When optimizing performance-critical code paths, eliminate redundant operations and unnecessary processing:...
-
Avoid flaky test patterns
influxdata/influxdb4⭐ 30268Write reliable tests by avoiding common patterns that can lead to flaky behavior. Specifically: 1. Avoid a...
-
Test all code paths
elie222/inbox-zero4⭐ 8267Write comprehensive tests that cover all code paths including edge cases, error conditions, and different p...
-
Prevent workflow recursion
elie222/inbox-zero4⭐ 8267Control GitHub Actions workflow execution to avoid infinite loops and unnecessary builds. Implement these p...
-
Normalize API responses
elie222/inbox-zero4⭐ 8267Design APIs to return consistent response structures across different data sources or providers. Normalize ...
-
Handle AI operation failures
elie222/inbox-zero4⭐ 8267Always implement proper error handling for AI service operations. AI services can fail due to rate limiting...
-
Ensure API contract integrity
elie222/inbox-zero4⭐ 8267Maintain strict consistency between API implementation and contract by ensuring: 1. Request/response schema...
-
Define schema relations correctly
elie222/inbox-zero4⭐ 8267When designing database schemas, ensure relations and constraints are explicitly and correctly defined: 1....
-
Complete hook dependency arrays
elie222/inbox-zero4⭐ 8267Ensure all hooks (useEffect, useCallback, useMemo) explicitly list every dependency used within their callb...
-
Cache invariant computations
elie222/inbox-zero4⭐ 8267Avoid repeatedly computing values that don't change frequently. For data structures, maps, or validation sc...
-
Semantic variable naming
hyprwm/Hyprland4⭐ 28863Variable names should clearly convey their purpose, type, and units to improve code readability and prevent...
-
prefer std::error_code parameters
hyprwm/Hyprland4⭐ 28863When using std::filesystem operations, prefer passing std::error_code parameters instead of relying on try-...
-
prefer managed pointers
hyprwm/Hyprland4⭐ 28863Raw pointers are banned in new code unless absolutely necessary. Instead, use managed pointer types to prev...
-
Precise documentation language
hyprwm/Hyprland4⭐ 28863Documentation language should be precise, unambiguous, and clearly scoped to prevent misinterpretation whil...
-
Precise configuration patterns
hyprwm/Hyprland4⭐ 28863Use precise file patterns and correct installation paths in CMake configuration to avoid unintended inclusi...
-
use Option combinators
juspay/hyperswitch4⭐ 34028Leverage Rust's Option API methods like `map`, `and_then`, `is_some()`, and `filter` instead of manual patt...
-
Database schema consistency
juspay/hyperswitch4⭐ 34028Ensure database schema definitions are consistent with ORM annotations and include proper constraints for d...
-
Choose optimal algorithms
juspay/hyperswitch4⭐ 34028When implementing functionality, carefully evaluate and select the most efficient algorithmic approaches fo...
-
Standardize build configuration patterns
helix-editor/helix4⭐ 39026Explicitly define and standardize build configuration patterns across the project to ensure consistent beha...
-
hide implementation details
helix-editor/helix4⭐ 39026When designing APIs, avoid exposing internal structures, implementation details, or platform-specific conce...
-
consistent naming conventions
helix-editor/helix4⭐ 39026Maintain consistent naming patterns throughout your codebase, following established conventions and ensurin...
-
avoid quadratic complexity
helix-editor/helix4⭐ 39026When working with data structures, especially ropes and collections, avoid algorithms that result in quadra...
-
avoid panics gracefully
helix-editor/helix4⭐ 39026Replace panics, expects, and unwraps with graceful error handling that provides user feedback and allows th...
-
avoid hardcoded configuration values
helix-editor/helix4⭐ 39026Avoid hardcoding configuration values that affect user experience or behavior. Instead, make these values c...
-
Safe property access patterns
grafana/grafana4⭐ 68825Use appropriate null/undefined handling techniques based on the context to prevent runtime errors. Be mindf...
-
Prefer null-safe access
grafana/grafana4⭐ 68825Always use null-safe access patterns when dealing with potentially undefined values to prevent runtime erro...
-
Optimize performance patterns
grafana/grafana4⭐ 68825Choose efficient implementation patterns that improve performance. Apply these optimizations throughout you...
-
Name for purpose first
grafana/grafana4⭐ 68825Choose names that lead with their primary purpose or category, followed by specific details. This makes cod...
-
Minimize database joins
grafana/grafana4⭐ 68825Prefer direct filtering or specialized service methods over complex JOIN operations, especially when mainta...
-
Maintain configuration documentation accuracy
grafana/grafana4⭐ 68825Always ensure configuration documentation accurately reflects the current system capabilities, limitations,...
-
Judicious configuration management
grafana/grafana4⭐ 68825Carefully manage configuration options, including feature flags, to balance flexibility with maintainabilit...
-
Fail-safe security defaults
grafana/grafana4⭐ 68825Always implement security features with fail-safe defaults that deny access or disable insecure functionali...
-
Consistent semantic naming
grafana/grafana4⭐ 68825Use consistent, specific, and semantically appropriate naming conventions throughout the codebase. When cre...
-
Consistent API versioning approach
grafana/grafana4⭐ 68825Adopt and document a consistent approach to API versioning across your services. The chosen format should b...
-
Component architecture principles
grafana/grafana4⭐ 68825Extract logic that doesn't render JSX into custom hooks instead of components. Components that don't return...
-
User-focused documentation structure
block/goose4⭐ 19037Documentation should prioritize user needs and problems over technical implementation details. Start with t...
-
Optimize memory and algorithms
block/goose4⭐ 19037Focus on efficient memory usage and algorithm selection while preserving functionality. Apply these optimiz...
-
Handle errors intentionally
block/goose4⭐ 19037Avoid generic catch-all error handling that masks important failures. Instead, be selective about which err...
-
consolidate API parameters
block/goose4⭐ 19037Prefer consolidating common configuration and parameters in API constructors or base methods rather than re...
-
avoid concurrency anti-patterns
block/goose4⭐ 19037Avoid common concurrency anti-patterns that lead to race conditions, deadlocks, and unreliable behavior. Us...
-
AI terminology consistency
block/goose4⭐ 19037Maintain consistent terminology when describing AI systems, capabilities, and workflows throughout document...
-
Descriptive idiomatic identifiers
gin-gonic/gin4⭐ 83022Use descriptive names for variables, types, and interfaces that follow Go language idioms. Avoid single-let...
-
Consistent error patterns
gin-gonic/gin4⭐ 83022Implement consistent error handling patterns throughout your codebase to improve readability and maintainab...
-
Structure user documentation
ghostty-org/ghostty4⭐ 32864When documenting complex features or configuration options, structure your documentation with these four ke...
-
Semantic name clarity
ghostty-org/ghostty4⭐ 32864Names should clearly and accurately reflect the purpose of variables, methods, and other identifiers. Follo...
-
Prevent unnecessary memory operations
ghostty-org/ghostty4⭐ 32864Avoid redundant memory allocations and copies when simpler alternatives exist. This includes: 1. Use in-pl...
-
Optimize comparison patterns efficiently
ghostty-org/ghostty4⭐ 32864Choose efficient comparison patterns and algorithms based on the data type and use case. Key guidelines: 1...
-
In-tree build configurations
ghostty-org/ghostty4⭐ 32864Keep all build configuration files (Snapcraft, Flatpak manifests, etc.) in the repository alongside your co...
-
prefer settings over environment
google-gemini/gemini-cli4⭐ 65062Prefer settings.json over environment variables and CLI flags for user configuration options. Environment v...
-
Centralize proxy configuration
google-gemini/gemini-cli4⭐ 65062Avoid duplicate proxy configuration across your application by establishing a single point of proxy setup a...
-
Centralize configuration management
google-gemini/gemini-cli4⭐ 65062Prefer centralized configuration files (settings.json, settings.ts) over environment variables for applicat...
-
Validate with sensible defaults
fatedier/frp4⭐ 95938Implement a comprehensive configuration validation strategy that combines centralized validation functions ...
-
Follow Go naming conventions
fatedier/frp4⭐ 95938Adhere to Go's standard naming conventions for identifiers: 1. **Control visibility with capitalization**:...
-
Optimize migration code
laravel/framework4⭐ 33763When writing database migration code, prioritize clarity and efficiency to ensure migrations are reliable a...
-
Optimize loop operations
laravel/framework4⭐ 33763When writing loops, optimize for both readability and performance by following these key principles: 1. **...
-
Disable coverage in workflows
laravel/framework4⭐ 33763Keep code coverage tools disabled in CI/CD workflows unless they're specifically needed for generating cove...
-
Descriptive configuration keys
laravel/framework4⭐ 33763Configuration keys should clearly indicate their value type, units, or expected format to prevent misunders...
-
Test observable behavior
flutter/flutter4⭐ 172252Focus on testing what users see and experience rather than internal implementation details. Tests should ve...
-
Make errors explicit
flutter/flutter4⭐ 172252Always make error conditions explicit and visible rather than hiding them through silent failures, default ...
-
Future-proof configuration defaults
flutter/flutter4⭐ 172252When designing configuration options, avoid hardcoded values and ensure defaults can be changed in future v...
-
Validate configuration defaults
gofiber/fiber4⭐ 37560Configuration structs should validate input values and provide sensible defaults that work well in producti...
-
Use context for configuration
gofiber/fiber4⭐ 37560When accessing application state or configuration within request handlers, always use the context method `c...
-
Include practical examples
gofiber/fiber4⭐ 37560Documentation should include practical, working examples that demonstrate real-world usage scenarios. When ...
-
Document mutex usage
gofiber/fiber4⭐ 37560Always document mutex fields and their purpose, ensure proper locking/unlocking patterns, and avoid redunda...
-
Proper Handling of Promises in Fastify Implementations
fastify/fastify4⭐ 34000When implementing Fastify applications in TypeScript, it is important to follow consistent patterns for han...
-
Content negotiation design
fastify/fastify4⭐ 34000When building APIs, implement proper content negotiation to handle various media types in both requests and...
-
Consistent descriptive naming
fastify/fastify4⭐ 34000Use precise, consistent, and descriptive naming conventions throughout your code to enhance readability and...
-
Benchmark before choosing methods
fastify/fastify4⭐ 34000Always benchmark different implementation approaches for performance-critical operations before selecting a...
-
Use pytest fixtures effectively
fastapi/fastapi4⭐ 86871Tests should use pytest fixtures to improve organization, promote test isolation, and avoid code duplicatio...
-
Use early returns
fastapi/fastapi4⭐ 86871Decrease indentation levels in your code by using early returns for edge cases and guard conditions. This a...
-
Respect async execution order
fastapi/fastapi4⭐ 86871When working with asynchronous code, always be mindful of the execution order of operations, particularly w...
-
Proper HTTP status codes
fastapi/fastapi4⭐ 86871When implementing authentication and authorization systems, use semantically correct HTTP status codes to a...
-
Optimize hot paths
expressjs/express4⭐ 67300When writing code that will be executed frequently (hot paths), prioritize performance optimizations that r...
-
Optimize dependency automation
expressjs/express4⭐ 67300Configure automated dependency update tools (like Dependabot) to balance security needs against developer c...
-
Access settings properly
expressjs/express4⭐ 67300Always use the provided settings accessor methods (`app.get()`, `app.set()`, `app.enabled()`, `app.disabled...
-
Algorithm selection correctness
evanw/esbuild4⭐ 39161Choose algorithms that correctly match the problem requirements and understand their computational properti...
-
mark experimental configuration features
electron/electron4⭐ 117644Always mark experimental and deprecated configuration options with appropriate stability indicators in docu...
-
Ensure async error cleanup
electron/electron4⭐ 117644Always ensure cleanup code executes and avoid creating dangling promises in error handling scenarios. Use t...
-
consistent nullable returns
electron/electron4⭐ 117644Establish consistent patterns for nullable return values in APIs and document them clearly. Use `null` cons...
-
Avoid exposing sensitive APIs
electron/electron4⭐ 117644Do not enable configurations that expose Node.js or Electron APIs to untrusted web content in renderer proc...
-
Parallel branch traceability
elastic/elasticsearch4⭐ 73104When implementing algorithms with parallel processing branches, ensure proper traceability and data consist...
-
Exceptions for critical errors
elastic/elasticsearch4⭐ 73104Use exceptions rather than assertions for handling critical error conditions that need to be caught in prod...
-
Defensive null handling
elastic/elasticsearch4⭐ 73104Always handle null references and values defensively to prevent NullPointerExceptions and unexpected behavi...
-
Configure type serialization
elastic/elasticsearch4⭐ 73104When working with databases that exchange data with other systems, ensure proper serialization and deserial...
-
Clarity over uncertainty
elastic/elasticsearch4⭐ 73104Technical documentation should use precise language that clearly differentiates between product behavior an...
-
preserve serialization compatibility
duckdb/duckdb4⭐ 32061When making changes to serialized data structures, always preserve backward and forward compatibility to pr...
-
prefer settings over pragmas
duckdb/duckdb4⭐ 32061When implementing configuration options, prefer database settings over pragma functions to maintain consist...
-
optimize hot path performance
duckdb/duckdb4⭐ 32061Avoid expensive operations in frequently executed code paths by implementing performance optimizations such...
-
maintain API backward compatibility
duckdb/duckdb4⭐ 32061When evolving APIs, prioritize backward compatibility by creating new methods or overloads rather than modi...
-
Constructor configuration injection
duckdb/duckdb4⭐ 32061Prefer injecting configuration objects through constructors rather than passing them as ad-hoc parameters o...
-
comprehensive database testing
duckdb/duckdb4⭐ 32061Database tests should execute actual queries and verify results comprehensively, not just check query plans...
-
Use standardized logging pattern
stanfordnlp/dspy4⭐ 27813Always use the standardized logging pattern with module-level loggers instead of print statements or direct...
-
Optional dependency management
stanfordnlp/dspy4⭐ 27813Avoid including optional or provider-specific dependencies in the main dependency list. Dependencies should...
-
Configuration context consistency
drizzle-team/drizzle-orm4⭐ 29461Ensure configuration names, values, and settings accurately reflect their intended context and usage. Confi...
-
Prevent N+1 queries
django/django4⭐ 84182The N+1 query problem is one of the most common performance bottlenecks in Django applications. This occurs...
-
Optimize computational complexity
django/django4⭐ 84182Identify and reduce computational complexity in your code by minimizing redundant operations and simplifyin...
-
Measure before optimizing
django/django4⭐ 84182Always measure performance impact before implementing optimizations and focus on changes with meaningful be...
-
Defend against nulls
django/django4⭐ 84182Always use defensive programming techniques when handling potentially null or empty values to avoid runtime...
-
Use dynamic configuration access
discourse/discourse4⭐ 44898Always access configuration values through proper service APIs rather than hardcoding them or using unrelia...
-
Safe setting modifications
discourse/discourse4⭐ 44898When modifying site settings during operations like imports, jobs, or plugin initialization, implement prop...
-
Include contextual log information
discourse/discourse4⭐ 44898Log messages should include sufficient context to make them useful for debugging, monitoring, and audit tra...
-
Consistent null safety patterns
discourse/discourse4⭐ 44898Apply null safety operators consistently throughout your code to prevent runtime errors and improve readabi...
-
Avoid N+1 queries
discourse/discourse4⭐ 44898Prevent N+1 query performance issues by batching database operations instead of making individual queries w...
-
API parameter handling
discourse/discourse4⭐ 44898Ensure consistent and safe handling of parameters and data across API endpoints. This includes using proper...
-
API parameter clarity
discourse/discourse4⭐ 44898Design API parameters with clear naming, structured formats, and intuitive interfaces that are easy for cli...
-
Validate access controls
langgenius/dify4⭐ 114231Always implement comprehensive validation for access control mechanisms to prevent unauthorized access and ...
-
Name by semantic purpose
langgenius/dify4⭐ 114231Choose names that reflect the semantic purpose and meaning rather than implementation details or arbitrary ...
-
Validate operation permissions
denoland/deno4⭐ 103714Ensure appropriate permission checks are implemented before performing security-sensitive operations that a...
-
Use appropriate error types
denoland/deno4⭐ 103714Functions should use specific, appropriate error handling mechanisms rather than generic or brittle approac...
-
prefer safe optional returns
denoland/deno4⭐ 103714When designing APIs and handling potentially missing or unavailable values, prefer returning optional types...
-
explicit dependency configuration
denoland/deno4⭐ 103714Ensure dependency configurations are explicit and predictable to avoid confusion and unexpected build behav...
-
defensive null handling
denoland/deno4⭐ 103714Use defensive programming patterns to prevent null-related issues before they occur. This includes creating...
-
Use modern API methods
deeplearning4j/deeplearning4j4⭐ 14036When implementing algorithms with numerical libraries like ND4J, always prefer the most direct and type-saf...
-
Minimize object allocations
deeplearning4j/deeplearning4j4⭐ 14036Avoid creating unnecessary temporary objects or arrays which can impact performance through increased garba...
-
Keep configurations current
deeplearning4j/deeplearning4j4⭐ 14036Ensure all configuration elements (dependencies, build settings, preprocessor flags) are up-to-date, docume...
-
Fail fast clearly
deeplearning4j/deeplearning4j4⭐ 14036Detect and report errors as early as possible with detailed context to prevent silent failures and aid debu...
-
Document AI APIs completely
deeplearning4j/deeplearning4j4⭐ 14036When developing AI libraries and tools, provide comprehensive and accurate API documentation that helps use...
-
Cross-platform algorithm optimization
deeplearning4j/deeplearning4j4⭐ 14036When implementing algorithms that need to execute efficiently across different platforms, consider both com...
-
Configurable resource locations
deeplearning4j/deeplearning4j4⭐ 14036Always make file paths, temporary directories, and resource locations configurable with reasonable defaults...
-
Compare floating-point safely
deeplearning4j/deeplearning4j4⭐ 14036When implementing numerical algorithms, never compare floating-point values directly for equality due to pr...
-
Use precise networking terminology
cypress-io/cypress4⭐ 48850When writing error messages or documentation related to network requests and cross-origin policies, use pre...
-
prefer existence over truthiness
cypress-io/cypress4⭐ 48850Use explicit existence checks instead of truthiness checks when dealing with object properties, null/undefi...
-
meaningful test assertions
cypress-io/cypress4⭐ 48850Write tests that verify specific behavior and outcomes rather than relying on weak assertions like snapshot...
-
GraphQL mutation design
cypress-io/cypress4⭐ 48850Design GraphQL mutations to return meaningful objects rather than simple booleans, and use simple ID parame...
-
Environment variable handling
cypress-io/cypress4⭐ 48850Environment variables should be properly validated, parsed, and documented with clear override mechanisms. ...
-
Choose appropriate log levels
cypress-io/cypress4⭐ 48850Select log levels based on the intended audience and actionability of the message. Use `debug` for internal...
-
Default None not empty
crewaiinc/crewai4⭐ 33945Always use `None` as the default value for optional parameters and class attributes instead of empty collec...
-
Pause tracking during side-effects
vuejs/core4⭐ 50769When executing side-effects in reactive systems (like event handlers, cleanup functions, or async operation...
-
Optimize common search paths
vuejs/core4⭐ 50769Implement dedicated fast paths for common search patterns while maintaining a complete fallback path for ed...
-
log complete error objects
adonisjs/core4⭐ 18071Always log complete error objects rather than just error messages to preserve stack traces, error codes, an...
-
Guarantee cleanup execution
vuejs/core4⭐ 50769When implementing features that require cleanup or state restoration, always use try-finally blocks to ensu...
-
Consistent documentation language
home-assistant/core4⭐ 80450Maintain consistency in wording, formatting, and specificity across all documentation strings to improve re...
-
Batch operations efficiently
home-assistant/core4⭐ 80450Collect and execute similar operations together rather than performing them individually to reduce overhead...
-
API documentation consistency
home-assistant/core4⭐ 80450Ensure all API-related descriptions, field names, and documentation accurately reflect the terminology and ...
-
Working configuration examples
continuedev/continue4⭐ 27819Configuration examples should be complete, accurate, and ready to use without modification. This applies to...
-
Safe property access
continuedev/continue4⭐ 27819Always use proper null safety patterns when accessing properties that might be null or undefined. This prev...
-
Prevent broken interactions
continuedev/continue4⭐ 27819Ensure UI elements' visual state (e.g., disabled, active) always matches their actual behavior. When an ele...
-
Prevent async deadlocks
continuedev/continue4⭐ 27819Avoid circular dependencies in asynchronous code paths that can lead to deadlocks or indefinite blocking. W...
-
Maintain API compatibility
continuedev/continue4⭐ 27819When modifying existing APIs, ensure backward compatibility to prevent runtime failures and minimize migrat...
-
Write deterministic test assertions
docker/compose4⭐ 35858Tests should be deterministic and explicit in their assertions to ensure reliability and maintainability. F...
-
Wrap and check errors
docker/compose4⭐ 35858Always wrap errors with meaningful context and use typed error checking instead of string matching. This he...
-
Use standard API fields
docker/compose4⭐ 35858When designing APIs or interfaces, prioritize using existing standard fields and patterns from established ...
-
Use API options pattern
docker/compose4⭐ 35858Design API methods using options objects instead of multiple parameters. This pattern provides better exten...
-
Prevent unintended CI behaviors
docker/compose4⭐ 35858Ensure CI/CD pipelines maintain predictable and reliable behavior by avoiding changes that introduce unexpe...
-
Prevent sensitive data exposure
docker/compose4⭐ 35858Implement comprehensive checks to prevent accidental exposure of sensitive data through multiple vectors in...
-
Keep code structure flat
docker/compose4⭐ 35858Maintain code readability by minimizing nesting depth and using appropriate control structures. Prefer flat...
-
consistent formatting choices
docker/compose4⭐ 35858Maintain consistent formatting and style choices throughout your codebase to improve readability and mainta...
-
Configuration documentation clarity
docker/compose4⭐ 35858Ensure configuration documentation clearly and accurately describes environment variables, command-line fla...
-
use logging over print
comfyanonymous/ComfyUI4⭐ 83726Replace all `print()` statements with appropriate logging calls using Python's built-in logging module. Thi...
-
optimize computational efficiency
comfyanonymous/ComfyUI4⭐ 83726Implement memoization and guard clauses to eliminate redundant computations and improve algorithmic perform...
-
explicit null handling strategies
comfyanonymous/ComfyUI4⭐ 83726Functions and APIs should employ explicit strategies for handling null/None values rather than leaving null...
-
Document complex code
comfyanonymous/ComfyUI4⭐ 83726Add explanatory comments or docstrings for complex, specialized, or non-obvious code that may not be immedi...
-
Semantic naming patterns
openai/codex4⭐ 31275Use names that clearly convey purpose and maintain consistency across related components. Avoid generic ide...
-
Prefer specific identifiers
openai/codex4⭐ 31275Always use specific, descriptive names for identifiers rather than generic terms. Names should clearly indi...
-
Organize code top down
openai/codex4⭐ 31275Structure code files with a clear top-down organization, placing primary functions and important declaratio...
-
Minimize blocking operations
openai/codex4⭐ 31275When writing concurrent code, minimize blocking operations to maintain responsiveness and prevent performan...
-
Leverage style tools
openai/codex4⭐ 31275Maintain consistent code style by using and respecting the project's established formatting tools and patte...
-
Avoid hard-coded configuration
openai/codex4⭐ 31275Make scripts and applications flexible by avoiding hard-coded configuration values. Instead, allow users to...
-
Strategic telemetry implementation
cline/cline4⭐ 48299Implement telemetry collection strategically to ensure system reliability and meaningful data capture. Plac...
-
Avoid generic suffixes
cline/cline4⭐ 48299Avoid using generic suffixes like "Response", "Result", or "Request" in type names, especially for non-requ...
-
Setting declaration practices
ClickHouse/ClickHouse4⭐ 42425Always declare settings before using them and optimize access patterns for performance. Settings must be pr...
-
Documentation precision standards
ClickHouse/ClickHouse4⭐ 42425Ensure API documentation uses precise type specifications, proper formatting, and clear language to improve...
-
Write actionable documentation
snyk/cli4⭐ 5178Documentation should be written in active voice with concrete examples and clear context. Avoid passive con...
-
Use centralized configuration access
snyk/cli4⭐ 5178Always access configuration values through the configuration object rather than direct helper functions or ...
-
Optimize variable declarations
snyk/cli4⭐ 5178Declare variables close to their usage point and choose appropriate types to improve code readability and r...
-
debug logging reliability
snyk/cli4⭐ 5178Ensure debug logging behaves correctly by only activating when debug flags are explicitly enabled, while pr...
-
avoid hardcoded configuration values
snyk/cli4⭐ 5178Replace hardcoded URLs, ports, file paths, and environment-specific strings with configurable parameters. H...
-
Use strict test doubles
chef/chef4⭐ 7860Always use strict test doubles (instance_double, class_double) instead of basic doubles or OpenStruct in te...
-
Standardize installation directory paths
chef/chef4⭐ 7860Maintain consistent and separate installation paths for different build types to prevent conflicts and impr...
-
Secure network operations
chef/chef4⭐ 7860When performing network operations, prioritize security and configurability to ensure robustness across dif...
-
Document configuration decisions
chef/chef4⭐ 7860Add clear comments explaining the rationale behind configuration decisions, especially for workarounds, com...
-
Document configuration completely
chef/chef4⭐ 7860Always provide complete documentation for configuration options, including defaults, override methods, and ...
-
Use pytest best practices
bridgecrewio/checkov4⭐ 7668Adopt modern pytest features to create maintainable, isolated, and comprehensive tests. This includes: 1. ...
-
Preserve API compatibility
bridgecrewio/checkov4⭐ 7668When modifying existing APIs, function signatures, or return structures, always maintain backward compatibi...
-
Precise configuration validation
bridgecrewio/checkov4⭐ 7667Ensure configuration validation logic accurately reflects security intentions and best practices. When writ...
-
Provide error feedback
calcom/cal.com4⭐ 37732Always provide clear user feedback when errors occur or operations fail, rather than allowing silent failur...
-
Prefer early returns
calcom/cal.com4⭐ 37732Use early returns and guard clauses instead of nested if-else statements to improve code readability and re...
-
optimize iteration patterns
calcom/cal.com4⭐ 37732Minimize computational complexity by optimizing iteration patterns and data processing flows. Apply early f...
-
Configuration access patterns
calcom/cal.com4⭐ 37732Ensure configuration data is accessed through proper service layers with dependency injection rather than d...
-
Avoid redundant operations
calcom/cal.com4⭐ 37732Identify and eliminate duplicate or inefficient operations that waste computational resources. Common patte...
-
Avoid generic naming
calcom/cal.com4⭐ 37732Choose specific, descriptive names over generic ones for all identifiers including variables, functions, co...
-
Use consistent test patterns
oven-sh/bun4⭐ 79093Standardize testing by leveraging established patterns and helper functions throughout your test suite. Ext...
-
Consistent descriptive identifiers
oven-sh/bun4⭐ 79093Use camelCase for all variables, parameters, methods, and functions in JavaScript/TypeScript code to mainta...
-
Clear accurate documentation
oven-sh/bun4⭐ 79093Documentation should be both technically accurate and contextually helpful for developers. Comments and JSD...
-
Always await promises
oven-sh/bun4⭐ 79093Consistently use the `await` keyword when working with Promise-returning functions to ensure proper executi...
-
validate LLM reliability
browser-use/browser-use4⭐ 69139Always validate LLM capabilities before deployment and implement robust handling for unreliable responses. ...
-
Simplify complex implementations
browser-use/browser-use4⭐ 69139Replace verbose, complex code structures with simpler, more readable alternatives. Prefer existing methods ...
-
optimize CI performance
browser-use/browser-use4⭐ 69139Structure CI workflows to minimize execution time and resource usage through strategic job organization, ca...
-
avoid external test dependencies
browser-use/browser-use4⭐ 69139Tests should not rely on external URLs, live websites, or internet connectivity to ensure reliability, cons...
-
Structured environment configuration
Homebrew/brew4⭐ 44168Use structured environment variable handling with explicit validation instead of directly accessing ENV has...
-
Correct GitHub Actions annotations
Homebrew/brew4⭐ 44168When using GitHub Actions workflow commands for annotations, always include double colons in the syntax (::...
-
Avoid variable name abbreviations
Homebrew/brew4⭐ 44168Use complete, descriptive variable names instead of abbreviations to enhance code readability and maintaina...
-
Structure for readability
boto/boto34⭐ 9417Prioritize code readability by structuring code in a way that makes it easy to understand at a glance. This...
-
Isolate concurrent resources
boto/boto34⭐ 9417Create separate instances of non-thread-safe resources for each thread or process in concurrent application...
-
Consistent region configuration
boto/boto34⭐ 9417Always maintain consistency in region configurations throughout your application. Instead of hardcoding end...
-
Expose essential configurations
better-auth/better-auth4⭐ 19651Carefully evaluate which configuration options should be exposed to users versus kept internal. Not all con...
-
derive from session context
better-auth/better-auth4⭐ 19651Always derive sensitive identifiers and permissions from the authenticated session context rather than acce...
-
validate feature configurations
bazelbuild/bazel4⭐ 24489Always validate that required features are enabled before using feature-dependent functionality. Feature fl...
-
preserve exception causes
bazelbuild/bazel4⭐ 24489When catching an exception and re-throwing a different exception type, always preserve the original excepti...
-
Ensure documentation completeness
bazelbuild/bazel4⭐ 24489All code elements should have sufficient documentation to understand their purpose, usage, and context. Thi...
-
build action separation
bazelbuild/bazel4⭐ 24489Keep build actions focused on their core responsibility and move complex logic to appropriate abstraction l...
-
Write deterministic tests
Azure/azure-sdk-for-net4⭐ 5809Tests should be deterministic, reliable, and isolated from external dependencies to ensure consistent resul...
-
User-friendly configuration values
Azure/azure-sdk-for-net4⭐ 5809Prefer intuitive, user-friendly values for configuration options over technical "magic strings" or codes th...
-
Standardize environment variables
Azure/azure-sdk-for-net4⭐ 5809Ensure environment variable names are consistently spelled, properly referenced, and follow established nam...
-
Externalize configuration values
Azure/azure-sdk-for-net4⭐ 5809Store configuration values (URLs, demands, pool names) in centralized variables rather than hardcoding them...
-
Use Option combinators
tokio-rs/axum4⭐ 22100Instead of verbose conditional logic, prefer Rust's Option combinators like map, and_then, and filter for h...
-
Structure errors for safety
tokio-rs/axum4⭐ 22100Create specific error types with appropriate status codes while ensuring sensitive details are logged but n...
-
Minimize memory allocation overhead
tokio-rs/axum4⭐ 22100Optimize performance by minimizing unnecessary memory allocations and using allocation-efficient APIs. Key ...
-
Lock carefully in async
tokio-rs/axum4⭐ 22100When using locks in async code, follow critical guidelines to avoid deadlocks. Never hold std::sync::Mutex ...
-
Handle protocol headers properly
tokio-rs/axum4⭐ 22100When implementing network services, especially proxies and protocol handlers, proper HTTP header management...
-
Validate security-critical inputs
axios/axios4⭐ 107000Always validate and sanitize user-supplied inputs before using them in security-sensitive operations. This ...
-
Robust Axios Usage in TypeScript
axios/axios4⭐ 107000This review focuses on ensuring robust and type-safe usage of the Axios library in TypeScript codebases. Ke...
-
Proper Error Handling in Axios TypeScript Code
axios/axios4⭐ 107000As a code reviewer, it is important to ensure that Axios-based TypeScript code properly handles and propaga...
-
Extract for better readability
axios/axios4⭐ 107000Complex expressions and repeated code should be extracted into well-named variables to improve readability ...
-
Maintain consistent formatting
aws/aws-sdk-js4⭐ 7628Enhance code readability and maintainability by applying consistent formatting practices throughout your co...
-
Validate untrusted inputs
argoproj/argo-cd4⭐ 20149Always validate and sanitize user-provided inputs to prevent injection attacks, particularly path traversal...
-
Simplify code readability
argoproj/argo-cd4⭐ 20149Prioritize code readability by using clearer control structures, extracting complex expressions into descri...
-
optimize algorithmic complexity
argoproj/argo-cd4⭐ 20149Always consider computational complexity and performance when implementing algorithms. Look for opportuniti...
-
explicit security controls
argoproj/argo-cd4⭐ 20149Security configurations should use explicit controls and secure defaults rather than implicit permissions o...
-
document network requirements
argoproj/argo-cd4⭐ 20149When documenting network-dependent features, explicitly specify all network configuration requirements incl...
-
design extensible APIs
argoproj/argo-cd4⭐ 20149When designing APIs, prioritize extensibility and backwards compatibility over convenience. Avoid modifying...
-
Ensure proper async context
appwrite/appwrite4⭐ 51959Always wrap asynchronous operations (await, suspend functions, try-await) in the appropriate language-speci...
-
Cypress test isolation
appwrite/appwrite4⭐ 51959Ensure end-to-end tests are properly isolated and follow best practices for reliability. Tests should avoid...
-
Use semantic naming
ant-design/ant-design4⭐ 95882Choose semantic, non-redundant names that clearly express intent and context. Remove unnecessary prefixes w...
-
Update deprecated demo APIs
ant-design/ant-design4⭐ 95882Documentation, demos, and example code should always use current, non-deprecated APIs instead of showing de...
-
Test organization standards
ant-design/ant-design4⭐ 95882Write tests that are well-organized, maintainable, and reflect real usage patterns. Test names should descr...
-
Handle optional values safely
ant-design/ant-design4⭐ 95882Always provide safe defaults or fallbacks when working with optional or potentially undefined values. Avoid...
-
Deprecated API documentation
ant-design/ant-design4⭐ 95882When documenting deprecated APIs, follow consistent practices to provide clear guidance to developers while...
-
Use specific descriptive names
angular/angular4⭐ 98611Choose specific, meaningful names that clearly communicate purpose rather than generic or ambiguous alterna...
-
Guard nullable value access
angular/angular4⭐ 98611Always use appropriate guards or type checks before accessing potentially null or undefined values. Prefer ...
-
Configuration opt-in safety
angular/angular4⭐ 98611When introducing new configuration options or making changes that could be disruptive, make them opt-in by ...
-
Choose appropriate presentation formats
angular/angular4⭐ 98611Select the most effective format for presenting different types of information in documentation. Use tables...
-
Choose appropriate algorithms
angular/angular4⭐ 98611Select algorithms and data structures that match the problem domain and access patterns rather than using c...
-
Avoid reactive over-engineering
angular/angular4⭐ 98611Choose the simplest React primitive that meets your requirements rather than reaching for complex reactive ...
-
async resource cleanup
angular/angular4⭐ 98611Always ensure proper cleanup of asynchronous resources (subscriptions, timeouts, event listeners) to preven...
-
Platform-specific API documentation
alacritty/alacritty4⭐ 59675The provided discussions focus on terminal emulator documentation and configuration issues, but do not cont...
-
consistent error handling
alacritty/alacritty4⭐ 59675Maintain uniform error handling patterns throughout the codebase. Avoid mixing different error handling app...
-
Safe constraint modification sequence
apache/airflow4⭐ 40858When modifying constraints in database migrations, follow a safe sequence of operations to prevent integrit...
-
Parameterize similar tests
apache/airflow4⭐ 40858Write parameterized tests instead of using for loops or duplicating test code for similar test cases. Using...
-
Optimize collection processing patterns
apache/airflow4⭐ 40858Use Python's built-in efficient collection processing methods instead of manual implementations. This reduc...
-
Leverage backend API capabilities
apache/airflow4⭐ 40858When consuming APIs in frontend applications, utilize the backend capabilities rather than reimplementing e...
-
Explicit version constraints
apache/airflow4⭐ 40858Always specify explicit version constraints for dependencies in configuration files (like pyproject.toml), ...
-
Explicit over implicit configuration
apache/airflow4⭐ 40858Always prefer explicit configuration parameters over inferring behavior from indirect sources like image ta...
-
Ensure deterministic queries
apache/airflow4⭐ 40858Build SQLAlchemy queries that are both efficient and deterministic to prevent unpredictable results and imp...
-
Document public API boundaries
apache/airflow4⭐ 40858Clearly define and document the boundaries between public and internal APIs to guide developers on proper i...
-
Context-rich log messages
apache/airflow4⭐ 40858Ensure log messages provide clear context about what happened, potential consequences, and actionable infor...
-
Consistent technical term translation
apache/airflow4⭐ 40858When localizing an application, maintain consistent conventions for technical terms while respecting langua...
-
Component reuse first
apache/airflow4⭐ 40858Always prioritize reusing existing components before creating new ones. This practice improves codebase con...
-
Handle errors gracefully
Aider-AI/aider4⭐ 35856Always implement appropriate error handling to prevent crashes while providing clear feedback to users. Con...
-
Externalize configuration values
Aider-AI/aider4⭐ 35856Always externalize configuration values rather than hardcoding them directly in the code. This improves mai...
-
Place configurations appropriately
vercel/ai4⭐ 15590Configuration options should be organized based on their nature and scope of use. Place model-specific conf...
-
Explicit code organization patterns
vercel/ai4⭐ 15590Maintain clear and explicit code organization patterns by following these guidelines: 1. Use explicit prop...
-
Self-explanatory identifier names
zed-industries/zed3⭐ 62119Choose identifier names that clearly convey their purpose without requiring users to understand implementat...
-
Respect language-specific conventions
zed-industries/zed3⭐ 62119Always adhere to the established formatting and syntax conventions of each programming language while maint...
-
Maintain style consistency
zed-industries/zed3⭐ 62119Ensure consistent styling is maintained across related elements in the codebase. This applies to: 1. **Vis...
-
Maintain consistent naming
zed-industries/zed3⭐ 62119Ensure naming follows consistent patterns throughout the codebase in both style and structure: 1. Use agre...
-
Hierarchical configuration organization
zed-industries/zed3⭐ 62119Organize configuration settings hierarchically by grouping related settings under meaningful namespaces rat...
-
Optimize build configurations
facebook/yoga3⭐ 18255When configuring CMake builds, carefully select compiler and linker flags that optimize for performance whi...
-
Measure optimization trade-offs
facebook/yoga3⭐ 18255Always measure and document the impact of performance optimizations before implementing them. When making o...
-
Document complex logic
facebook/yoga3⭐ 18255Add clear explanatory comments to complex calculations, platform-specific behavior, or non-obvious code sec...
-
Design familiar APIs
facebook/yoga3⭐ 18255Design APIs that align with platform conventions and user expectations rather than creating novel patterns....
-
consistent formatting choices
facebook/yoga3⭐ 18255Maintain consistent formatting and structural choices throughout the codebase to improve readability and ma...
-
Analyze performance trade-offs
facebook/yoga3⭐ 18255Before implementing convenience features or making architectural decisions, carefully evaluate their perfor...
-
Algorithm specification compliance
facebook/yoga3⭐ 18255When implementing layout algorithms, ensure strict adherence to web standards and specifications, particula...
-
Add safety checks
facebook/yoga3⭐ 18255Always add appropriate safety checks before operations that could result in undefined behavior, null refere...
-
Remove unnecessary configurations
cloudflare/workers-sdk3⭐ 3379Configuration files should only include options that are supported in production and work out of the box. R...
-
HTTP response construction
cloudflare/workers-sdk3⭐ 3379Use appropriate HTTP response construction methods and status codes for API endpoints. Prefer `Response.jso...
-
eliminate redundant null checks
cloudflare/workers-sdk3⭐ 3379Remove unnecessary null/undefined checks when you already have sufficient validation in place, and use prop...
-
Wrap throwing operations
cloudflare/workerd3⭐ 6989Always wrap potentially throwing operations in try/catch blocks to prevent unhandled exceptions from crashi...
-
Use KJ_UNWRAP_OR pattern
cloudflare/workerd3⭐ 6989When handling potentially null values from functions like `tryParse()` or `tryCast()`, avoid the pattern of...
-
Simplify async patterns
cloudflare/workerd3⭐ 6989Use modern promise utilities and clean async patterns instead of manual promise construction. Prefer Promis...
-
prefer nullish coalescing operators
cloudflare/workerd3⭐ 6989Use nullish coalescing operators (`??`) and logical OR with safe defaults (`|| {}`) to handle null and unde...
-
document security-sensitive features
cloudflare/workerd3⭐ 6989When introducing compatibility flags, feature toggles, or APIs that have security implications, use self-do...
-
defer async callbacks
cloudflare/workerd3⭐ 6989Always ensure callbacks and event emissions are executed asynchronously to maintain proper timing and Node....
-
Clear descriptive naming
cloudflare/workerd3⭐ 6989Choose names that clearly communicate intent without requiring mental gymnastics to understand. Avoid doubl...
-
Choose efficient algorithms
cloudflare/workerd3⭐ 6989When implementing algorithms, prioritize efficiency in both time and space complexity. Consider these speci...
-
Centralize error handling
cloudflare/workerd3⭐ 6989Consolidate error handling logic into central, unavoidable locations rather than scattering it across multi...
-
Parallelize independent operations
microsoft/vscode3⭐ 174887When writing concurrent code, always execute independent operations in parallel rather than sequentially to...
-
Comprehensive JSDoc with examples
microsoft/vscode3⭐ 174887Write thorough JSDoc comments for interfaces, functions, and methods that clearly explain their purpose and...
-
Avoid CSS !important
microsoft/vscode3⭐ 174887Using `!important` in CSS declarations should be avoided as it makes styles difficult to override and maint...
-
Standardize configuration formats
volcano-sh/volcano3⭐ 4899Ensure all plugin configurations follow a consistent, structured format across the codebase to improve main...
-
Secure configuration practices
volcano-sh/volcano3⭐ 4899Implement secure configuration practices to protect sensitive data and prevent security vulnerabilities. Th...
-
Justify default enablement
volcano-sh/volcano3⭐ 4899When adding new configuration options, carefully consider whether features should be enabled by default. Re...
-
Extract configuration constants
volcano-sh/volcano3⭐ 4899Avoid hardcoded values and magic numbers in configuration-related code by extracting them as named constant...
-
Document technical details clearly
volcano-sh/volcano3⭐ 4899Ensure all technical documentation provides clear explanations and follows proper formatting conventions. T...
-
Secure before deployment
vllm-project/vllm3⭐ 51730Remove or secure development-specific code before deploying to production environments. Development artifac...
-
Structured configuration management
vitessio/vitess3⭐ 19815Avoid using global configuration singletons that rely on string-based lookups, as they lead to brittle code...
-
Robust network handling
vitessio/vitess3⭐ 19815Always implement proper network timeout handling and address formatting to ensure robust connectivity acros...
-
Secure workflow permissions
vitejs/vite3⭐ 74031Define explicit and minimal permissions in GitHub Actions workflows to ensure proper operation while mainta...
-
Restrict server access
vitejs/vite3⭐ 74031Always configure server security settings with explicit allowed lists rather than permissive values. Using ...
-
comprehensive validated examples
vlang/v3⭐ 36582Documentation examples should be self-sufficient, comprehensive, and use proper syntax tags to enable autom...
-
Avoid breaking API changes
vlang/v3⭐ 36582When modifying existing public APIs, always maintain backward compatibility to avoid breaking existing user...
-
Short-circuit evaluation strategies
astral-sh/uv3⭐ 60322When implementing search or traversal algorithms, use short-circuit evaluation strategically to avoid unnec...
-
Optimize cache sharing strategies
astral-sh/uv3⭐ 60322Select the appropriate cache sharing approach based on your execution environment to maximize performance a...
-
Follow established naming conventions
astral-sh/uv3⭐ 60322Adhere to established naming conventions for files, variables, functions, and configuration options to main...
-
Enforce strong optional types
astral-sh/uv3⭐ 60322Use strong typing and early validation to handle optional values and prevent null-related issues. Prefer en...
-
Declarative constraints over runtime
astral-sh/uv3⭐ 60322Design APIs that enforce constraints through type systems and declarative mechanisms rather than runtime ch...
-
prefer efficient operations
Unstructured-IO/unstructured3⭐ 12116Choose efficient operations and algorithms over expensive alternatives, particularly when processing data o...
-
API examples completeness
Unstructured-IO/unstructured3⭐ 12117Ensure all API code examples include all required parameters with correct placeholder values. Incomplete ex...
-
use meaningful error types
unionlabs/union3⭐ 74800Replace generic exceptions with context-specific error types that provide meaningful information about what...
-
use Effect Option consistently
unionlabs/union3⭐ 74800Replace null, undefined, and error throwing with Effect's Option type for handling potentially missing valu...
-
Use configuration service injection
unionlabs/union3⭐ 74800Replace mutable singletons and getter functions with dependency injection services for configuration-depend...
-
SQL query best practices
unionlabs/union3⭐ 74800Always include ORDER BY clauses in paginated queries to ensure consistent results across multiple requests....
-
Reuse existing API utilities
unionlabs/union3⭐ 74800Before implementing custom API utilities, serializers, or type identification methods, check if equivalent ...
-
organize code for readability
unionlabs/union3⭐ 74800Structure code to maximize readability and maintainability through clear organization patterns. Use top-lev...
-
Maintain naming consistency
unionlabs/union3⭐ 74800Ensure consistent terminology and naming conventions across the entire codebase. Use the same identifier na...
-
Choose appropriate async primitives
unionlabs/union3⭐ 74800Select async/concurrency primitives based on your specific usage patterns and requirements rather than defa...
-
avoid hardcoded configuration
unionlabs/union3⭐ 74800Avoid hardcoding configuration values directly in code. Instead, make parameters configurable through CLI a...
-
avoid error display duplication
unionlabs/union3⭐ 74800When using thiserror for error handling, avoid displaying source errors in both the error message and the s...
-
Prevent object recreations
shadcn-ui/ui3⭐ 90568Avoid creating new objects and functions repeatedly during renders to reduce memory pressure and improve pe...
-
Leverage framework defaults
shadcn-ui/ui3⭐ 90568Avoid redundant or unnecessary configuration by understanding and utilizing default behaviors provided by f...
-
Complete optional chaining
shadcn-ui/ui3⭐ 90568When using optional chaining (`?.`), ensure that **all subsequent operations** in the chain are also protec...
-
Complete configuration paths
shadcn-ui/ui3⭐ 90568Always verify that configuration files include all necessary file paths and extensions, particularly for fr...
-
Preserve naming consistency
microsoft/typescript3⭐ 105378Maintain consistent naming patterns and casing across all related code entities to ensure clarity and preve...
-
Eliminate unnecessary constructs
microsoft/typescript3⭐ 105378Remove redundant or unnecessary code constructs to improve readability and maintainability. This includes a...
-
Structure documentation logically
astral-sh/ty3⭐ 11919Organize documentation sections and content to match user mental models and workflows, not internal technic...
-
Ensure CI dependency reliability
astral-sh/ty3⭐ 11919CI workflows should use the most current versions of dependencies and ensure all required tools are availab...
-
Use proper PostgreSQL types
twentyhq/twenty3⭐ 35477Leverage PostgreSQL's native data types and features instead of generic alternatives to improve performance...
-
Use proper null utilities
twentyhq/twenty3⭐ 35477Use dedicated null checking utilities like `isDefined` or `isUndefinedOrNull` instead of generic type coerc...
-
Security-critical code review
twentyhq/twenty3⭐ 35477Changes to security-sensitive areas like authentication, input validation, and business logic require extra...
-
Choose appropriate concurrency patterns
twentyhq/twenty3⭐ 35477Select concurrency mechanisms that align with your system architecture and established codebase patterns. A...
-
Avoid repeated expensive operations
twentyhq/twenty3⭐ 35477Replace repeated expensive operations like `find()`, `filter()`, or `sort()` with pre-computed maps or cach...
-
Validate configuration structures
vercel/turborepo3⭐ 28115Ensure configuration files and schemas adhere to their expected structure, location, and uniqueness constra...
-
Use functional null handling
vercel/turborepo3⭐ 28115Leverage Rust's functional operators for handling nullable and optional values. Instead of using unwrap() o...
-
Use affected mode
vercel/turborepo3⭐ 28115Optimize CI pipelines by running tasks only on packages affected by code changes. Use the `--affected` flag...
-
Standardize package manager commands
vercel/turborepo3⭐ 28115Ensure all package manager commands in documentation and CI/CD scripts follow the correct syntax for the sp...
-
Semantic naming conventions
vercel/turborepo3⭐ 28115Use names that clearly convey the purpose and content of variables, parameters, and properties. When workin...
-
Minimize lock duration
vercel/turborepo3⭐ 28115When using locks in asynchronous code, minimize the scope and duration for which locks are held, especially...
-
Document configuration alternatives
vercel/turborepo3⭐ 28115When documenting commands or tools that can be executed in different ways based on configuration settings (...
-
Document cache strategies
vercel/turborepo3⭐ 28115Always provide clear documentation and implementation for caching strategies, including key generation, inv...
-
Write explicit concrete tests
tree-sitter/tree-sitter3⭐ 21799Tests should be written explicitly with concrete examples and clear assertions rather than being generated ...
-
optimize parser development strategy
tree-sitter/tree-sitter3⭐ 21799When developing parsers or grammars, apply strategic optimization by prioritizing commonly used language fe...
-
optimize dependency configurations
tree-sitter/tree-sitter3⭐ 21799When configuring dependencies in package manifests, prioritize efficiency and maintainability by avoiding r...
-
API pattern consistency
tree-sitter/tree-sitter3⭐ 21799When designing new API functions, maintain consistent patterns across the codebase and avoid creating prece...
-
Remove unused code elements
traefik/traefik3⭐ 55772Eliminate unnecessary code elements including unused parameters, struct tags, methods, and dead code to imp...
-
descriptive contextual logging
traefik/traefik3⭐ 55772Log messages should be descriptive, contextual, and provide actionable information. Include relevant contex...
-
Optimize job structure
tokio-rs/tokio3⭐ 28989Structure CI jobs for clarity, parallelism, and efficiency. Each job should have a single, well-defined pur...
-
Optimize CI job structure
tokio-rs/tokio3⭐ 28981Structure your CI workflows to maximize performance and clarity. Each job should have a single, clear respo...
-
Minimize unsafe code
tokio-rs/tokio3⭐ 28981When writing code that requires unsafe operations, follow these critical security practices: 1. Minimize t...
-
Clear command documentation
tokio-rs/tokio3⭐ 28989When documenting shell commands in technical documentation, use the `shell` language identifier instead of ...
-
Thread-safe resource sharing
huggingface/tokenizers3⭐ 9868When sharing mutable data between threads, use the `Arc
>` pattern to ensure thread safety. `Arc` ... -
Pythonic API design
huggingface/tokenizers3⭐ 9868Design APIs that follow Python language conventions and idioms rather than blindly mirroring the underlying...
-
Purpose-indicating descriptive names
huggingface/tokenizers3⭐ 9868Choose names for variables, methods, parameters, and fixtures that clearly communicate their purpose, conte...
-
Optimize workflow triggers
huggingface/tokenizers3⭐ 9868Configure CI workflows with targeted triggers and path filters to balance thoroughness with efficiency. Run...
-
Modular model components
huggingface/tokenizers3⭐ 9868Design machine learning model code with clear component boundaries and proper separation of concerns. Each ...
-
Manage version constraints
huggingface/tokenizers3⭐ 9868When configuring dependency version constraints in project files, follow these principles: 1. Be explicit ...
-
Technical precision matters
hashicorp/terraform3⭐ 45532When documenting algorithms, data structures, and computational processes, use precise and objective langua...
-
Document implementation rationale
microsoft/terminal3⭐ 99242Add comments that explain the reasoning behind non-obvious code decisions, technical constraints, or comple...
-
Clear accurate error messages
microsoft/terminal3⭐ 99242Error messages should be clear, accurate, and contextually appropriate to help users understand what went w...
-
Validate tensor inputs safely
tensorflow/tensorflow3⭐ 190625When handling tensor inputs that may contain invalid values, use transformational approaches rather than co...
-
Separate test data
tensorflow/tensorflow3⭐ 190625Large test data should be separated from test logic to improve readability and maintainability. Move test d...
-
Use dedicated configuration files
temporalio/temporal3⭐ 14953Always use dedicated configuration files for specific configuration needs rather than modifying core build ...
-
Structured contextual logging
temporalio/temporal3⭐ 14953Always use structured logging with appropriate tags instead of string concatenation or formatting. Include ...
-
Operation order affects correctness
temporalio/temporal3⭐ 14953When implementing algorithms that involve multiple operations (like iteration, validation, and execution), ...
-
Minimize code nesting depth
temporalio/temporal3⭐ 14953Reduce cognitive load and improve code readability by minimizing nested code blocks. Prefer early returns a...
-
Context-aware network calls
temporalio/temporal3⭐ 14953Always propagate context through network calls to ensure proper cancellation, timeout handling, and tracing...
-
Use structured API parameters
gravitational/teleport3⭐ 19109When designing APIs with multiple related parameters, especially optional ones like filters, sorting, and p...
-
Use semantically clear names
gravitational/teleport3⭐ 19109Choose names that clearly convey their purpose, scope, and meaning to reduce ambiguity and improve code mai...
-
Use descriptive semantic names
gravitational/teleport3⭐ 19109Choose descriptive, semantic names that clearly convey purpose and meaning rather than generic or ambiguous...
-
Provide contextual error messages
gravitational/teleport3⭐ 19109Error messages should be specific, contextual, and use appropriate error creation functions to help users u...
-
Plan encryption key recovery
gravitational/teleport3⭐ 19109Always implement recovery mechanisms and plan for key rotation when designing encryption systems. Encryptio...
-
Follow platform naming standards
gravitational/teleport3⭐ 19109Adhere to established naming conventions specific to each platform, framework, or technology being used. Di...
-
Avoid overly broad permissions
gravitational/teleport3⭐ 19109Use specific, scoped permissions instead of wildcards to prevent unintended access to sensitive resources. ...
-
API parameter encapsulation
gravitational/teleport3⭐ 19109When designing API methods that accept multiple related parameters (especially filters, search criteria, or...
-
Training-aware ML APIs
tensorflow/swift3⭐ 6136Design machine learning APIs with explicit parameters for distinguishing between training and inference pha...
-
Swift idiomatic naming
tensorflow/swift3⭐ 6136Follow Swift's naming conventions to write more readable, maintainable code. The Swift language emphasizes ...
-
Provide comprehensive examples
tensorflow/swift3⭐ 6136API documentation should include complete examples that demonstrate all key usage patterns. When documentin...
-
Generic algorithm design
tensorflow/swift3⭐ 6136When implementing generic algorithms in Swift, follow these best practices to improve code clarity and perf...
-
Format for readability
tensorflow/swift3⭐ 6136Code should be formatted to optimize readability. Apply these key practices: 1. **Maintain reasonable line...
-
Follow Swift naming conventions
tensorflow/swift3⭐ 6136Ensure code follows established Swift naming conventions and remains consistent with domain terminology: 1...
-
Document API stability
tensorflow/swift3⭐ 6136When working with AI frameworks and machine learning libraries, clearly document the stability state of API...
-
API version management
SWE-agent/SWE-agent3⭐ 16839When integrating with external APIs, explicitly handle version differences and use parameterized configurat...
-
preserve user input focus
sveltejs/svelte3⭐ 83580When implementing reactive state updates that affect input elements, always check if the user is currently ...
-
Multi-indicator configuration detection
sveltejs/svelte3⭐ 83580When detecting configuration states, use multiple indicators rather than relying on a single source of trut...
-
Descriptive migration comments
sveltejs/svelte3⭐ 83580When adding migration task comments, always include specific details about why manual intervention is requi...
-
async cleanup safety
sveltejs/svelte3⭐ 83580Ensure async operations include proper safety checks to prevent race conditions, memory leaks, and inconsis...
-
analyze transitive dependencies
sveltejs/svelte3⭐ 83580When implementing dependency analysis algorithms, ensure comprehensive tracking of both direct and transiti...
-
Use parameter-based paths
supabase/supabase3⭐ 86070When designing API routes and interfaces, always use parameter-based path syntax instead of hardcoded liter...
-
Use configuration over hardcoding
supabase/supabase3⭐ 86070Always use configuration constants instead of hardcoding values directly in the code. This improves maintai...
-
Prevent re-render triggers
supabase/supabase3⭐ 86070Avoid creating new object/array references in component render functions and carefully manage state updates...
-
Explicit role security management
supabase/supabase3⭐ 86070Always be explicit about role privileges when configuring database security. Remember that both `authentica...
-
Explicit null handling
supabase/supabase3⭐ 86070Use explicit patterns when dealing with potentially null or undefined values to prevent runtime errors and ...
-
Database entity configuration
supabase/supabase3⭐ 86070Configure database entities with appropriate defaults and clear type distinctions. For triggers, prefer AFT...
-
Centralize configuration values
supabase/supabase3⭐ 86070Extract and centralize configuration values instead of duplicating or hardcoding them throughout the codeba...
-
Abstract user-facing errors
supabase/supabase3⭐ 86070Error messages displayed to end users should abstract away implementation details while providing actionabl...
-
prefer lazy computation
browserbase/stagehand3⭐ 16443Avoid precomputing expensive operations when they may not be needed, especially for large datasets. Instead...
-
Configure workflow triggers
browserbase/stagehand3⭐ 16443Ensure GitHub Actions workflows are triggered appropriately by configuring branch patterns and path filters...
-
abstract environment variables
browserbase/stagehand3⭐ 16443Avoid directly referencing environment variables throughout your codebase. Instead, abstract them into name...
-
Standardize configuration formats
spring-projects/spring-framework3⭐ 58382Use consistent, explicit, and well-documented formats in all configuration files to improve readability and...
-
Package null-safety annotations
spring-projects/spring-framework3⭐ 58382All package-info.java files must include both @NonNullApi and @NonNullFields annotations to establish null-...
-
Optimize CI environment configuration
spring-projects/spring-framework3⭐ 58382When configuring CI environments, carefully evaluate whether default dependency versions are sufficient for...
-
Leverage Kotlin null-safety
spring-projects/spring-framework3⭐ 58382Utilize Kotlin's null-safety features effectively to create cleaner, more robust code: 1. For class proper...
-
Database-agnostic SQL syntax
spring-projects/spring-framework3⭐ 58382Write SQL statements that conform to standard SQL rather than relying on vendor-specific dialects to ensure...
-
Clone network headers carefully
spring-projects/spring-framework3⭐ 58382When working with HTTP or WebSocket headers in networking code, be cautious about header manipulation, clon...
-
Validate nulls properly
spring-projects/spring-boot3⭐ 77637Always use appropriate null validation mechanisms to prevent NullPointerExceptions and ensure code robustne...
-
Reference existing configurations
spring-projects/spring-boot3⭐ 77637When setting up configuration files, reference existing configuration sources rather than duplicating value...
-
Verify CI build consistency
apache/spark3⭐ 41554Ensure CI pipelines thoroughly verify build outputs and maintain consistency across different build tools a...
-
use modern Java syntax
apache/spark3⭐ 41554Prefer modern Java language features and constructs to write more concise, readable code. Since Apache Spar...
-
Use descriptive names
apache/spark3⭐ 41554Choose names that clearly convey purpose and context rather than generic or vague terms. Names should be se...
-
Proper synchronization patterns
apache/spark3⭐ 41554When implementing synchronization mechanisms, avoid common anti-patterns that can lead to performance issue...
-
parameterize configuration values
apache/spark3⭐ 41554Replace hardcoded configuration values with parameterized variables in build files and configuration manage...
-
minimize public API surface
apache/spark3⭐ 41554Only expose APIs that are truly necessary for external consumers and avoid creating public interfaces that ...
-
context-independent schema design
apache/spark3⭐ 41554Database schema elements (views, constraints, tables) should be designed to be context-independent and self...
-
comprehensive test coverage
apache/spark3⭐ 41554Ensure test suites provide comprehensive coverage by including edge cases, boundary conditions, and input v...
-
Use semantic naming
bytedance/sonic3⭐ 8532Choose names that clearly communicate the purpose, meaning, and scope of variables, functions, constants, a...
-
optimize algorithms by characteristics
bytedance/sonic3⭐ 8532When implementing algorithms, make optimization decisions based on the specific characteristics of your dat...
-
Consistent semantic naming
bytedance/sonic3⭐ 8532Maintain consistent naming conventions throughout the codebase and use semantically clear identifiers that ...
-
use design tokens
SigNoz/signoz3⭐ 23369Replace hardcoded color values, spacing, and other design-related constants with design tokens or CSS custo...
-
Use descriptive contextual names
SigNoz/signoz3⭐ 23369Choose variable, method, and property names that clearly communicate their purpose and context to avoid con...
-
Use database transactions
SigNoz/signoz3⭐ 23369Always use database transactions when performing operations that require atomicity or could create race con...
-
standardize authentication context extraction
SigNoz/signoz3⭐ 23369Always use the standardized `authtypes.ClaimsFromContext` method for extracting authentication claims from ...
-
measure before optimizing
SigNoz/signoz3⭐ 23369Always measure performance impact before making optimization decisions or skipping potential optimizations ...
-
API payload completeness
SigNoz/signoz3⭐ 23369Ensure all required fields are included in API payloads and handle special field cases properly to prevent ...
-
optimize tensor operations
sgl-project/sglang3⭐ 17245When working with PyTorch tensors, prioritize operations that avoid unnecessary memory allocations and copi...
-
Explicit API parameters
sgl-project/sglang3⭐ 17245API functions should use explicit parameters rather than passing large opaque objects. When a function need...
-
Environment variable best practices
sgl-project/sglang3⭐ 17245Avoid reading environment variables directly in performance-critical code paths, especially during model fo...
-
Document AI limitations
sgl-project/sglang3⭐ 17245When implementing AI model support or hardware backends, clearly document known limitations, compatibility ...
-
Handle unsafe code properly
servo/servo3⭐ 32962Methods that access raw memory buffers, perform pointer operations, or interact with foreign function inter...
-
avoid borrow hazards
servo/servo3⭐ 32962Prevent borrow conflicts by collecting or cloning data before operations that may trigger garbage collectio...
-
Provide contextual explanations
serverless/serverless3⭐ 46810Documentation should explain the reasoning, context, and practical implications behind code examples, not j...
-
Simple explicit interfaces
oraios/serena3⭐ 14465Design API interfaces to be simple and explicit rather than hiding complexity behind elaborate fallbacks or...
-
Write comprehensive assertions
getsentry/sentry3⭐ 41297When writing tests, ensure your assertions thoroughly verify all relevant aspects of the functionality bein...
-
Structured metric naming
getsentry/sentry3⭐ 41297Create metrics with descriptive, unique names that are distinguishable when viewed in monitoring tools. Avo...
-
Simplify feature flag logic
getsentry/sentry3⭐ 41297When working with feature flags and configuration conditions, keep your logic clean and up-to-date: 1. **S...
-
Prefer bulk operations
getsentry/sentry3⭐ 41297When implementing functionality that processes multiple items, always consider the performance implications...
-
Minimize file memory footprint
getsentry/sentry-php3⭐ 1873When handling files in your application, minimize memory usage to optimize performance. Follow these guidel...
-
Memoize expensive computations effectively
getsentry/sentry3⭐ 41297Prevent unnecessary recalculations and rerenders by properly memoizing expensive computations and derived v...
-
Consistent URL design
getsentry/sentry3⭐ 41297Design API endpoints with consistent, unambiguous URL patterns to improve usability and maintainability. Fo...
-
Clear consistent naming patterns
getsentry/sentry3⭐ 41297Use clear, consistent naming patterns for variables and event handlers. Avoid abbreviations unless they are...
-
Centralize AI code
getsentry/sentry3⭐ 41297Move AI-specific functionality (especially prompts) to dedicated services rather than scattering them throu...
-
API parameter design flexibility
getsentry/sentry3⭐ 41297Design API parameters to be extensible and future-proof by using object arguments and explicit type definit...
-
Algorithm structure optimization
getsentry/sentry3⭐ 41297Optimize algorithm structure by separating concerns and using appropriate data structures and language feat...
-
Use typed interfaces
semgrep/semgrep3⭐ 12598Prefer typed interfaces over dictionary access to enable static type checking and prevent null reference er...
-
Use descriptive variable names
semgrep/semgrep3⭐ 12598Choose variable and parameter names that clearly communicate their purpose and avoid misleading or cryptic ...
-
Ensure comprehensive test coverage
semgrep/semgrep3⭐ 12598Tests should validate all expected behaviors, variants, and edge cases rather than covering only the happy ...
-
Document configuration troubleshooting
semgrep/semgrep3⭐ 12598Configuration files and scripts should include comprehensive documentation that helps developers understand...
-
Defensive optional handling
semgrep/semgrep3⭐ 12598Always handle optional and nullable values defensively by checking for null/empty states before use and han...
-
Defensive authorization checks
semgrep/semgrep3⭐ 12598Always implement explicit authentication and authorization checks before granting access to premium feature...
-
Conservative security assumptions
semgrep/semgrep3⭐ 12598When implementing security measures, always err on the side of caution by making conservative assumptions a...
-
Add comprehensive test coverage
semgrep/semgrep3⭐ 12598Ensure all code changes include appropriate unit tests and address any identified testing gaps immediately....
-
Configuration default handling
strands-agents/sdk-python3⭐ 4044Use clean, simple patterns when accessing configuration values with defaults. Avoid redundant fallback oper...
-
Prevent TOCTOU vulnerabilities
rust-lang/rust3⭐ 105254Time-of-Check-to-Time-of-Use (TOCTOU) race conditions occur when a program checks a condition and then uses...
-
Default over unsafe initialization
rust-lang/rust3⭐ 105254Prefer using safe initialization methods like `Default::default()` over unsafe alternatives like `MaybeUnin...
-
Validate before access
dotnet/runtime3⭐ 16578Always validate parameters and initialize variables before access to prevent null dereference and undefined...
-
Preserve pointer authentication
dotnet/runtime3⭐ 16578When implementing Pointer Authentication (PAC) for security, maintain signed pointers throughout their enti...
-
Platform-agnostic network APIs
dotnet/runtime3⭐ 16578When implementing networking functionality, ensure code uses platform-agnostic APIs and appropriate abstrac...
-
Parameterize configuration values
dotnet/runtime3⭐ 16578Extract hard-coded configuration values into variables, parameters, or templates to improve reusability and...
-
Optimize build dependency chains
dotnet/runtime3⭐ 16578When configuring build and test processes in CI/CD pipelines, ensure proper dependency chains with clear in...
-
Memory ordering matters
dotnet/runtime3⭐ 16578When working with shared data in multithreaded environments, memory ordering is critical to prevent race co...
-
Choose descriptive names
dotnet/runtime3⭐ 16578Names should clearly convey purpose and meaning. Parameter, variable, and method names should be self-expla...
-
Verify union attribute access
astral-sh/ruff3⭐ 40619When working with union types in Python, always verify that all components of the union have the attributes...
-
Structure documentation effectively
astral-sh/ruff3⭐ 40619Documentation should follow a consistent structure where explanations precede code examples, preferably end...
-
Ensure algorithmic determinism
astral-sh/ruff3⭐ 40619When implementing algorithms for code analysis, type checking, or pattern matching, ensure they produce con...
-
Assert exact expectations
astral-sh/ruff3⭐ 40619Always assert exact expected values in tests rather than using loose assertions. When testing the presence ...
-
Use descriptive scoped names
TanStack/router3⭐ 11590Prefer descriptive, scoped names over generic or vague identifiers for types, functions, and properties. Na...
-
React hook dependencies
TanStack/router3⭐ 11590Carefully manage dependencies in React hooks to avoid stale closures and ensure correct behavior. When usin...
-
Environment file management
TanStack/router3⭐ 11590Ensure proper handling of environment files by following these practices: (1) Add actual environment files ...
-
Environment-aware configuration management
TanStack/router3⭐ 11590Ensure configuration management accounts for different environments and maintains backward compatibility du...
-
environment-aware API usage
TanStack/router3⭐ 11590Always detect the runtime environment before using environment-specific APIs or utilities. This is crucial ...
-
Choose efficient algorithms
TanStack/router3⭐ 11590Prefer built-in methods and appropriate data structures over manual implementations to improve both perform...
-
avoid unnecessary complexity
TanStack/router3⭐ 11590Remove code complexity that doesn't provide clear value, particularly in type definitions, configuration op...
-
algorithm implementation trade-offs
TanStack/router3⭐ 11590When implementing algorithms, carefully evaluate trade-offs between built-in methods, custom implementation...
-
Validate model capabilities first
RooCodeInc/Roo-Code3⭐ 17288Always validate AI model capabilities and configurations before attempting to use them. This includes check...
-
Use nullish coalescing
RooCodeInc/Roo-Code3⭐ 17288When providing default values for numeric properties, use the nullish coalescing operator (??) instead of l...
-
Use cryptographic randomness
RooCodeInc/Roo-Code3⭐ 17288Always use cryptographically secure random number generation for security-sensitive operations such as gene...
-
Sanitize untrusted content
RooCodeInc/Roo-Code3⭐ 17288Always sanitize user-generated or externally sourced content before rendering it to prevent Cross-Site Scri...
-
Prevent timeout race conditions
RooCodeInc/Roo-Code3⭐ 17288When working with timeouts and asynchronous operations that affect shared state, clear timeouts at the begi...
-
Centralize configuration constants
RooCodeInc/Roo-Code3⭐ 17288Always centralize configuration constants in a shared location and import them rather than duplicating valu...
-
validate null undefined values
smallcloudai/refact3⭐ 3114Always perform explicit null and undefined checks before accessing object properties or using values in ope...
-
Verify performance empirically
facebook/react3⭐ 237000Always validate performance optimizations through measurement rather than assumptions. Run multiple iterati...
-
Use appropriate testing methods
facebook/react3⭐ 237000When writing tests, use the appropriate testing utilities and ensure proper test isolation. For testing war...
-
Separate conditional paths
facebook/react3⭐ 237000When working with concurrent operations, separate conditional logic from potentially expensive or suspensef...
-
use modern JavaScript patterns
remix-run/react-router3⭐ 55270Adopt modern JavaScript syntax and patterns to improve code quality and maintainability. This includes usin...
-
TypeScript configuration setup
remix-run/react-router3⭐ 55270Ensure proper TypeScript configuration for generated types and development workflow. This includes setting ...
-
prefer explicit readable constructs
remix-run/react-router3⭐ 55270Choose explicit and semantic code constructs that enhance readability over more concise but less clear alte...
-
HTTP protocol compliance
remix-run/react-router3⭐ 55270Ensure code adheres to HTTP protocol standards and handles different protocol versions correctly. This incl...
-
graceful error handling
remix-run/react-router3⭐ 55270Implement error handling that gracefully degrades when operations fail, uses consistent reporting patterns,...
-
Extract test helpers
remix-run/react-router3⭐ 55270Create reusable helper functions for common test setup patterns to reduce duplication and improve maintaina...
-
documentation linking standards
remix-run/react-router3⭐ 55270Ensure proper linking and cross-referencing in documentation to improve navigation and discoverability. Use...
-
documentation generation compatibility
remix-run/react-router3⭐ 55270When making code changes, ensure compatibility with documentation generation tools like JSDoc and TypeDoc. ...
-
Document configuration rationale
remix-run/react-router3⭐ 55270When adding or modifying configuration files, always include clear comments or documentation explaining the...
-
Cancel aborted async operations
remix-run/react-router3⭐ 55270When working with async operations that can be aborted (like HTTP requests), ensure proper cancellation of ...
-
avoid redundant computations
remix-run/react-router3⭐ 55270Identify and eliminate repeated expensive operations to improve performance. Cache computationally expensiv...
-
Optimize React Component Dependencies
facebook/react3⭐ 237000When implementing React components, ensure that dependencies between component state, props, and side effec...
-
validate before operations
facebook/react-native3⭐ 123178Always explicitly check for null, undefined, or missing properties/methods before performing operations tha...
-
Simplify parsing algorithms
facebook/react-native3⭐ 123178When implementing parsing or processing algorithms, prioritize simplification and reusability over complex ...
-
Prevent regression crashes
facebook/react-native3⭐ 123178When implementing error handling or bug fixes, avoid introducing new crash conditions that would break prev...
-
Meaningful documentation practices
facebook/react-native3⭐ 123178Documentation should enhance code understanding rather than duplicate information already present in the co...
-
leverage framework cache mechanisms
facebook/react-native3⭐ 123178When implementing caching functionality, prefer using framework-provided cache mechanisms over manual cache...
-
Follow platform naming conventions
facebook/react-native3⭐ 123178Adhere to the established naming conventions and namespacing practices of your target platform. This includ...
-
Feature flag isolation
facebook/react-native3⭐ 123178Feature flags should be properly isolated and scoped to avoid mixing configuration concerns with core inter...
-
ensure exception safety
facebook/react-native3⭐ 123178Always ensure proper exception safety by placing cleanup code in @finally blocks, using stack-allocated exc...
-
consistent null checking
facebook/react-native3⭐ 123178Ensure null checks follow consistent patterns and proper ordering for better readability and safety. Always...
-
catch specific exceptions
facebook/react-native3⭐ 123178Always catch specific exception types rather than generic `Exception` to avoid masking unexpected errors an...
-
avoid unnecessary conversions
facebook/react-native3⭐ 123178Choose direct, efficient methods over approaches that require additional parsing, conversion, or processing...
-
Avoid expensive allocations
facebook/react-native3⭐ 123178Minimize object creation and expensive operations in performance-critical code paths, particularly in frequ...
-
Match errors to context
facebook/react3⭐ 237000Choose error handling mechanisms based on the error's severity and context. For critical issues that should...
-
Complete hook dependencies
facebook/react3⭐ 237000Always specify complete dependency arrays in React hooks to prevent bugs from stale closures and avoid unne...
-
Check property existence first
facebook/react3⭐ 237000Always verify that an object and its properties exist before accessing them to prevent 'cannot read propert...
-
Wrap threaded code properly
rails/rails3⭐ 57027When working with threads in Rails applications, always wrap application code with `Rails.application.execu...
-
Semantic HTML usage
rails/rails3⭐ 57027Use HTML elements according to their semantic purpose to ensure proper accessibility and code organization....
-
Environment-specific logger configuration
rails/rails3⭐ 57027Configure loggers in environment-specific files rather than in application.rb or initializers. Different en...
-
Document performance implications
rails/rails3⭐ 57027Clearly document the performance implications of features and configurations to help users make informed de...
-
Consistent terminology usage
rails/rails3⭐ 57027Always use consistent terminology for the same concept throughout your codebase, documentation, and user in...
-
Verify AI library compatibility
QwenLM/Qwen33⭐ 24226When specifying AI/ML library dependencies, ensure version compatibility between related packages and verif...
-
Configuration parameter documentation
QwenLM/Qwen33⭐ 24226Ensure all configuration parameters have explicit default values and are thoroughly documented. When using ...
-
Reuse test patterns
quarkusio/quarkus3⭐ 14667Minimize duplication and improve test maintainability by reusing existing test patterns and leveraging para...
-
Document deployment strategy constraints
quarkusio/quarkus3⭐ 14667Always document and enforce appropriate deployment strategies for different application types in your CI/CD...
-
Document dependency versions
quarkusio/quarkus3⭐ 14667When managing dependency versions in configuration files, provide clear documentation to help maintainers u...
-
Descriptive consistent naming
quarkusio/quarkus3⭐ 14667Use clear, descriptive names instead of cryptic abbreviations, and follow consistent naming patterns across...
-
Avoid request-path blocking
quarkusio/quarkus3⭐ 14667Minimize blocking operations in request-handling paths to ensure responsive application performance. Implem...
-
Thread context management
pytorch/pytorch3⭐ 91345Always explicitly set required thread context and state rather than assuming inheritance from parent thread...
-
Structure for readability
pytorch/pytorch3⭐ 91345Structure code to maximize readability by reducing unnecessary complexity. Use early returns to minimize ne...
-
Reusable workflow design
pytorch/pytorch3⭐ 91345Design CI/CD workflows with reusability and clear naming conventions from the start. Use meaningful prefixe...
-
Reduce code duplication
pytorch/pytorch3⭐ 91345Eliminate repeated code patterns by using appropriate abstraction techniques. This improves readability, re...
-
Purpose-revealing identifier names
pytorch/pytorch3⭐ 91345Choose identifier names that clearly reveal their purpose and behavior. Names should be specific, descripti...
-
Prefer HINTS in CMake
pytorch/pytorch3⭐ 91345When configuring library searches in CMake, use `HINTS` instead of `PATHS` when you want to prioritize spec...
-
Parameterize similar test cases
pytorch/pytorch3⭐ 91345Instead of duplicating test code or using nested loops, use test parameterization to handle multiple test c...
-
Modular configuration design
pytorch/pytorch3⭐ 91345Configuration systems should be designed with modularity and clarity in mind. When creating configuration c...
-
Document configuration decisions
pytorch/pytorch3⭐ 91345Always document configuration decisions in package metadata files like `pyproject.toml` with clear comments...
-
Consistent code organization
pytorch/pytorch3⭐ 91345Follow consistent code organization patterns: 1. Place static definitions in .cpp files rather than header...
-
Check CUDA availability first
pytorch/pytorch3⭐ 91345Always verify CUDA availability before performing CUDA-specific operations to prevent runtime errors when c...
-
Structured configuration management
pydantic/pydantic3⭐ 24377Configuration files should follow official standards, have up-to-date tool settings, and appropriate depend...
-
Preserve language conventions
pydantic/pydantic3⭐ 24377When designing APIs that bridge between programming languages and external data formats (like JSON, XML, et...
-
Explicit over implicit
pydantic/pydantic3⭐ 24377Always prefer explicit configuration settings over relying on implicit defaults or environmental behaviors ...
-
Documentation formatting standards
pydantic/pydantic3⭐ 24377Maintain consistent documentation formatting to ensure proper rendering and readability. Follow these key p...
-
Categorize error types
pydantic/pydantic3⭐ 24377Distinguish between different categories of errors and handle each appropriately. Specifically: 1. **Valid...
-
Use configuration placeholders
prowler-cloud/prowler3⭐ 11834Avoid hardcoding specific values like regions, timeframes, or identifiers in configuration commands, exampl...
-
Tenant-aware query optimization
prowler-cloud/prowler3⭐ 11834Always include tenant_id filters in database queries for multi-tenant systems to maintain data isolation an...
-
Pin GitHub Actions dependencies
prowler-cloud/prowler3⭐ 11834Always pin GitHub Actions to specific commit SHAs rather than using major version references to prevent sup...
-
Parameterize similar tests
prowler-cloud/prowler3⭐ 11834Write maintainable tests by using pytest parametrization for similar test cases instead of duplicating test...
-
Document dependency versioning
prowler-cloud/prowler3⭐ 11834Use consistent patterns for specifying dependency versions in configuration files and document reasoning be...
-
document test tool options
prometheus/prometheus3⭐ 59616When documenting test tools, migration utilities, or testing frameworks, provide comprehensive explanations...
-
Configuration design clarity
prometheus/prometheus3⭐ 59616Design configuration options to be unambiguous and self-documenting. Avoid reusing the same configuration f...
-
maintain clean CI configuration
prisma/prisma3⭐ 42967Keep CI/CD configuration files clean and self-documenting by removing outdated comments, using descriptive ...
-
Document configuration decisions
prisma/prisma3⭐ 42967Add explanatory comments to configuration files that clarify the reasoning behind non-obvious choices, feat...
-
Centralize configuration logic
prisma/prisma3⭐ 42967Avoid scattering configuration defaults, validation, and loading logic across multiple functions. Instead, ...
-
avoid quadratic complexity
prisma/prisma3⭐ 42967When processing collections, be mindful of time complexity and avoid accidentally creating O(N²) algorithms...
-
API abstraction levels
prisma/prisma3⭐ 42967Functions and utilities should operate at appropriate abstraction levels without being aware of higher-leve...
-
Organize tests properly
prettier/prettier3⭐ 50772Tests should be well-structured with clear separation of concerns, proper grouping, and appropriate cleanup...
-
Environment-specific error handling
prettier/prettier3⭐ 50772Separate development-time assertions from production error handling based on the runtime environment. Devel...
-
Ensure semantic naming accuracy
prettier/prettier3⭐ 50772Names should accurately reflect the actual behavior, constraints, and purpose of the code element they repr...
-
Validate inputs recursively
PostHog/posthog3⭐ 28460Always implement recursive validation and sanitization for user inputs, especially when dealing with encode...
-
Test complex logic thoroughly
PostHog/posthog3⭐ 28460When implementing complex business logic, state management, or algorithms with multiple edge cases, ensure ...
-
optimize data loading
PostHog/posthog3⭐ 28460Review data loading operations to ensure they are properly scoped, filtered, and batched to prevent perform...
-
Add explanatory tooltips
PostHog/posthog3⭐ 28460When UI elements have unclear functionality or purpose, add tooltips to provide immediate context and expla...
-
Feature flag compatibility
pola-rs/polars3⭐ 34296Design code to work correctly with any combination of feature flags. When implementing conditional compilat...
-
Favor clarity over brevity
pola-rs/polars3⭐ 34296Always prioritize code readability and maintainability over concise but cryptic implementations. Extract re...
-
Database API abstraction
pola-rs/polars3⭐ 34296When designing database interaction layers, carefully consider when to create wrapper methods versus allowi...
-
Create demonstrative examples
pola-rs/polars3⭐ 34296Include clear, concise examples in documentation that effectively demonstrate functionality. Follow these p...
-
Consistent naming standards
pola-rs/polars3⭐ 34296Maintain consistent and standardized naming throughout the codebase: 1. **Use snake_case for multi-word id...
-
CI workflow configuration best
pola-rs/polars3⭐ 34296Configure GitHub Actions workflows to maximize reliability and maintainability. Follow these key practices:...
-
Pin configuration versions
python-poetry/poetry3⭐ 33496Always pin specific versions for base images, dependencies, and environment configurations to ensure reprod...
-
manage testing dependencies
python-poetry/poetry3⭐ 33496Ensure testing dependencies are properly organized, avoid redundancy, and proactively manage unmaintained p...
-
maintain security constraints
python-poetry/poetry3⭐ 33496Always preserve existing security constraints and validation mechanisms rather than weakening them for conv...
-
avoid redundant tool configuration
python-poetry/poetry3⭐ 33496When configuring code style tools, avoid enabling rules or settings that duplicate functionality already pr...
-
Use modern null-safe operators
microsoft/playwright3⭐ 76113Prefer optional chaining (`?.`) and nullish coalescing (`??`) operators over verbose null checks and ternar...
-
prefer CSS over JavaScript
microsoft/playwright3⭐ 76113Use CSS solutions instead of JavaScript state management for simple styling and interactions. This approach...
-
optimize React rerenders
microsoft/playwright3⭐ 76113Ensure React components avoid unnecessary rerenders by maintaining object identity in dependencies and elim...
-
Environment variable validation
microsoft/playwright3⭐ 76113Environment variables should be properly validated, parsed, and have sensible fallback values. Always valid...
-
consistent spacing grid
microsoft/playwright3⭐ 76113Use consistent spacing values that follow a standardized grid system, typically multiples of 4px or 8px, ra...
-
Use semantic naming
emcie-co/parlant3⭐ 12205Choose names that clearly communicate the purpose, behavior, or domain concept rather than generic or abbre...
-
Optimize CI/CD workflows
opentofu/opentofu3⭐ 25901Configure CI/CD workflows to maximize efficiency and improve developer experience. Consider these key optim...
-
Names preserve cognitive context
opentofu/opentofu3⭐ 25901Choose variable, function, and type names that preserve cognitive context by clearly indicating their purpo...
-
Explicit versus dynamic configurations
opentofu/opentofu3⭐ 25901Prefer explicit hardcoded configurations over dynamic ones when the configuration changes infrequently and ...
-
Document reference standards
opentofu/opentofu3⭐ 25901Maintain consistent and accurate reference practices throughout project documentation to enhance usability ...
-
Structured changelog documentation
open-telemetry/opentelemetry-python3⭐ 2061Maintain consistent and informative changelog documentation by following these practices: 1. Structure cha...
-
Maintain consistent naming
open-telemetry/opentelemetry-python3⭐ 2061Ensure naming conventions are consistent across your codebase and related repositories. When naming command...
-
Explicit CI configurations
open-telemetry/opentelemetry-python3⭐ 2061Always use explicit, specific configurations in CI/CD pipelines to prevent ambiguity and conflicts. This in...
-
Test independence design
commaai/openpilot3⭐ 58214Tests should be designed to be independent and avoid coupling to implementation details. Use public interfa...
-
Standardize configuration approaches
commaai/openpilot3⭐ 58214When documenting or implementing configuration procedures, prioritize standard, unified approaches over cus...
-
Pin dependency versions
commaai/openpilot3⭐ 58214Always pin specific versions of dependencies, tools, and commits in configuration files to ensure consisten...
-
Configuration defaults consistency
commaai/openpilot3⭐ 58214Ensure configuration parameters have appropriate default values, consistent naming conventions, and central...
-
Benchmark performance changes
commaai/openpilot3⭐ 58214Always include performance benchmarks when making changes that could impact execution speed, CPU usage, or ...
-
Use specific descriptive names
opengrep/opengrep3⭐ 1546Choose names that clearly indicate the specific purpose, scope, or domain of functions, variables, and type...
-
contextual failure handling
opengrep/opengrep3⭐ 1546Implement intelligent failure handling that makes contextual decisions about retry, cleanup, and error prop...
-
centralize configuration management
opengrep/opengrep3⭐ 1546Configuration values should be defined in a single location and passed through proper data structures rathe...
-
Validate tensor dimensions
opencv/opencv3⭐ 82865When implementing AI model inference code, always validate tensor dimensions and shapes before manipulating...
-
Meaningful semantic naming
opencv/opencv3⭐ 82865Choose names that clearly communicate purpose and follow consistent patterns across the codebase: 1. Use g...
-
Feature flag convention
opencv/opencv3⭐ 82865Establish a consistent pattern for feature flags and dependency management in configuration files: 1. Use ...
-
Cleanup before errors
opencv/opencv3⭐ 82865Always ensure all resources are properly released before raising errors to prevent resource leaks. This pra...
-
Use descriptive specific names
sst/opencode3⭐ 28213Choose names that clearly communicate purpose and scope rather than generic or overly broad terms. Names sh...
-
reuse existing code
sst/opencode3⭐ 28213Before implementing new functionality, check if similar utilities or patterns already exist in the codebase...
-
Ensure naming consistency
sst/opencode3⭐ 28213Maintain consistent naming for the same entities across different contexts including code, documentation, A...
-
avoid hardcoded configuration values
sst/opencode3⭐ 28213Configuration values such as URLs, endpoints, timeouts, and environment-specific settings should never be h...
-
Use portable path configurations
ollama/ollama3⭐ 145705Build and configuration scripts should use portable path handling techniques to ensure they work correctly ...
-
Optimize AI implementation patterns
ollama/ollama3⭐ 145705When implementing AI systems, prioritize established patterns and optimizations rather than creating new im...
-
Complete null checks
ollama/ollama3⭐ 145705Always perform thorough null checks before dereferencing pointers, and ensure all operations on potentially...
-
AI memory management
ollama/ollama3⭐ 145705Document and implement proper memory management strategies for AI model inference to prevent out-of-memory ...
-
Abstract configuration access
octokit/octokit.net3⭐ 2793Use abstraction layers to access configuration settings rather than accessing environment variables, featur...
-
Use proper synchronization primitives
nrwl/nx3⭐ 27518When implementing concurrent operations, always use appropriate synchronization mechanisms and ensure all a...
-
Security terminology consistency
nrwl/nx3⭐ 27518Ensure consistent formatting and precise terminology when documenting security-related concepts, access con...
-
Follow established naming patterns
nrwl/nx3⭐ 27518Ensure all identifiers, file references, and generated names follow established conventions and patterns ra...
-
Cache expensive calculations
nrwl/nx3⭐ 27518Avoid recalculating expensive operations in frequently called methods by caching results and only recalcula...
-
avoid redundant CI operations
nrwl/nx3⭐ 27518CI/CD processes should eliminate unnecessary repetition and redundant operations across projects and builds...
-
prefer != null comparisons
nuxt/nuxt3⭐ 57769When checking for null or undefined values, prefer the concise `!= null` comparison over explicit checks or...
-
Check SSR context
nuxt/nuxt3⭐ 57769Always verify execution context (server vs client) before running client-specific operations in SSR applica...
-
Build documentation clarity
nuxt/nuxt3⭐ 57769Ensure build and deployment documentation clearly explains processes, outputs, and environment options to p...
-
Benchmark algorithmic optimizations
nuxt/nuxt3⭐ 57769Always validate performance improvements with benchmarks rather than assuming algorithmic optimizations pro...
-
Provide specific error context
novuhq/novu3⭐ 37700Error messages should be specific and contextual rather than generic, helping users understand exactly what...
-
Optimize database queries
novuhq/novu3⭐ 37700Structure database queries and schemas for optimal performance by avoiding nullable fields when possible, o...
-
consistent naming patterns
novuhq/novu3⭐ 37700Establish and maintain consistent naming conventions across similar components and contexts. Inconsistent n...
-
Use modern nullish operators
nodejs/node3⭐ 112178When dealing with potentially null or undefined values, use optional chaining (`?.`) and nullish coalescing...
-
Use appropriate metric types
nodejs/node3⭐ 112178When instrumenting applications with metrics, choose the correct metric type based on what you're measuring...
-
Reuse computed values efficiently
nodejs/node3⭐ 112178Move variable declarations and computations outside of loops when their values don't change between iterati...
-
Resource-aware programming patterns
nodejs/node3⭐ 112178When optimizing application performance, be mindful of system resource constraints and use appropriate patt...
-
Export environment variables once
nodejs/node3⭐ 112178When writing shell scripts, set and export all environment variables at the top of the script rather than m...
-
Write concise idiomatic code
vercel/next.js3⭐ 133000Favor concise and idiomatic expressions in your Rust code to improve readability and maintainability.
-
Verify workflow configuration integrity
vercel/next.js3⭐ 133000Carefully review GitHub Actions workflow configurations to prevent subtle errors that can cause CI/CD pipel...
-
Prefer Existence Checks in Next.js Components
vercel/next.js3⭐ 133000When working with props, state, or other values in Next.js components that may be null, undefined, or conta...
-
Optimize data structure selection
vercel/next.js3⭐ 133000Choose data structures that match your specific access patterns and performance requirements. The right dat...
-
Consistent variable style patterns
vercel/next.js3⭐ 133000Maintain consistent patterns for variable declarations and naming conventions: use const by default for var...
-
Use semantically accurate names
ChatGPTNextWeb/NextChat3⭐ 85721Variable, method, and type names should precisely reflect their actual content, purpose, or scope. Names th...
-
Simplify conditional logic
ChatGPTNextWeb/NextChat3⭐ 85721Break down complex conditional expressions and control flow into simpler, more readable forms. Use early re...
-
Measure performance concerns
ChatGPTNextWeb/NextChat3⭐ 85721Before assuming performance issues exist, measure actual execution time and resource usage. When performanc...
-
Prevent test resource leaks
netty/netty3⭐ 34227Always ensure proper cleanup of resources in tests to prevent memory leaks. When using EmbeddedChannel, cal...
-
Consistent dependency declarations
netty/netty3⭐ 34227Ensure dependency declarations in build configuration files use concrete values rather than variables that ...
-
Use topological sorting
nestjs/nest3⭐ 71766When managing dependencies between modules or components, implement a topological sorting algorithm to ensu...
-
Use factory providers
nestjs/nest3⭐ 71767Prefer `useFactory` over `useValue` for better performance in NestJS dependency injection, especially for l...
-
Prevent race conditions
nestjs/nest3⭐ 71766When handling concurrent operations in asynchronous environments, avoid mutating shared state that could le...
-
Parameterize version requirements
nestjs/nest3⭐ 71767Always parameterize tool and runtime versions in CI/CD configurations rather than hardcoding them. This mak...
-
Optimize critical path iterations
nestjs/nest3⭐ 71767Use appropriate iteration techniques in performance-critical code paths to minimize overhead and maximize e...
-
Graph-based dependency management
nestjs/nest3⭐ 71767When managing module dependencies in a system, treat the dependencies as a directed graph and apply appropr...
-
reuse concurrency infrastructure
neovim/neovim3⭐ 91433Avoid implementing custom concurrency patterns when existing infrastructure is available. Before creating n...
-
prevent autocommand reentrancy
neovim/neovim3⭐ 91433Guard against reentrancy issues when operations may trigger autocommands or async events that could invalid...
-
Optimize algorithmic complexity
neovim/neovim3⭐ 91433Actively identify and eliminate unnecessary computational overhead in algorithms, particularly focusing on ...
-
Documentation formatting standards
neovim/neovim3⭐ 91433Ensure documentation follows consistent formatting standards to improve readability and maintainability. Th...
-
consistent algorithm interfaces
neovim/neovim3⭐ 91433When designing interfaces for filtering, traversal, or search algorithms, research existing codebase patter...
-
Secure authentication handling
neondatabase/neon3⭐ 19015Always implement proper authentication checks and protect sensitive credentials throughout your codebase. T...
-
Precise algorithm terminology
neondatabase/neon3⭐ 19015When implementing and documenting algorithms, use precise terminology and be explicit about metrics, operat...
-
Performance test pragmatism
neondatabase/neon3⭐ 19015When designing performance tests, focus on efficiency and meaningful insights rather than exhaustive combin...
-
Optimize data structures
neondatabase/neon3⭐ 19015When implementing algorithms, prioritize data structure choices that minimize resource usage while maintain...
-
Handle all error paths
neondatabase/neon3⭐ 19015Ensure comprehensive error handling throughout the codebase by implementing proper error handling blocks, d...
-
Guard against race conditions
neondatabase/neon3⭐ 19015When working with concurrent operations, always implement proper guards to prevent race conditions between ...
-
Extract and reuse
neondatabase/neon3⭐ 19015Create focused utility functions for repeated or complex operations instead of duplicating logic across the...
-
Environment-specific config defaults
neondatabase/neon3⭐ 19015Define appropriate configuration defaults for different environments (development, testing, production) usi...
-
Document API specs completely
neondatabase/neon3⭐ 19015When designing and implementing APIs, always provide comprehensive specifications that clearly document all...
-
Database before memory
neondatabase/neon3⭐ 19015When working with database systems that also maintain in-memory state, always update the persistent databas...
-
Configuration context alignment
neondatabase/neon3⭐ 19015Choose the appropriate configuration context based on how changes will be handled by the system. When defin...
-
Configurable cache parameters
neondatabase/neon3⭐ 19015Cache configurations should be runtime-configurable rather than hardcoded, with support for dynamic resizin...
-
Cache performance preservation
neondatabase/neon3⭐ 19015When implementing database failover or restart mechanisms, ensure performance consistency by preserving and...
-
Avoid flaky tests
neondatabase/neon3⭐ 19015Tests should be designed to be deterministic and reliable to prevent wasted developer time and false confid...
-
Adaptive cache expiration strategy
neondatabase/neon3⭐ 19015Design cache expiration policies that align with actual workload patterns rather than arbitrary timeframes....
-
Prevent element double-counting
n8n-io/n8n3⭐ 122978When working with graph structures, collections, or relationship mappings, ensure each element is processed...
-
Pin actions securely
n8n-io/n8n3⭐ 122978Always pin GitHub Actions to specific commit hashes rather than version tags to prevent supply chain attack...
-
Never commit credentials
n8n-io/n8n3⭐ 122978Credentials, passwords, API tokens, and database connection strings must never be committed to version cont...
-
Complete error handling cycle
n8n-io/n8n3⭐ 122978Implement comprehensive error handling that covers prevention, recovery, and diagnosis: 1. **Prevent error...
-
Use explicit optional types
apache/mxnet3⭐ 20801When dealing with values that may be absent or null, always use explicit optional type wrappers instead of ...
-
Documentation clarity and formatting
apache/mxnet3⭐ 20801When writing documentation (README files, tutorials, API docs), ensure clarity and proper formatting: 1. *...
-
Document environment variables
apache/mxnet3⭐ 20801All environment variables must be documented in the central env_var.md file with clear descriptions of thei...
-
Document API completely
apache/mxnet3⭐ 20801Always provide comprehensive API documentation that clearly specifies: 1. **Parameter types** - Document a...
-
Consistent logging format
apache/mxnet3⭐ 20801Use consistent string formatting in logging statements throughout the codebase. Prefer `%` style placeholde...
-
Centralize synchronization logic
apache/mxnet3⭐ 20801When implementing concurrent operations, especially in heterogeneous computing environments (CPU/GPU), cent...
-
Centralize configuration parameters
apache/mxnet3⭐ 20801Avoid hardcoded paths and duplicated configuration values throughout the code. Instead: 1. Use dedicated c...
-
Optimize React performance patterns
rocicorp/mono3⭐ 2091Prioritize React performance by avoiding expensive operations and using proper React patterns. Key practice...
-
enforce database constraints properly
rocicorp/mono3⭐ 2091Database schemas should use appropriate constraints to enforce business rules and prevent data inconsistenc...
-
Use design system tokens
mui/material-ui3⭐ 96063Always use design system tokens (theme values, breakpoints, spacing units) instead of hard-coded values. Th...
-
Maintain configuration accuracy
mui/material-ui3⭐ 96063Regularly audit configuration files to remove unused entries and ensure all configurations accurately refle...
-
Explicit configuration resolution
mui/material-ui3⭐ 96063Always use explicit path resolution and document ordering requirements in configuration files to prevent en...
-
Effect hook best practices
mui/material-ui3⭐ 96063When using React effect hooks, follow these practices to ensure predictable behavior and prevent memory lea...
-
Document implementation decisions
mui/material-ui3⭐ 96063Add explanatory comments for non-obvious implementation details, especially when maintaining backward compa...
-
Defensively handle nullables
mui/material-ui3⭐ 96063When working with values that could be null or undefined, implement defensive coding patterns to prevent ru...
-
Consistent component API patterns
mui/material-ui3⭐ 96063Design component APIs with consistent patterns that promote extensibility and clear usage. Prefer generic p...
-
Use safe type guards
mastodon/mastodon3⭐ 48691When implementing type guards for nullable or unknown types, use the `in` operator and property existence c...
-
optimize network configurations
mastodon/mastodon3⭐ 48691Optimize network configurations by eliminating redundancy, using modern compression standards, and properly...
-
optimize collection iterations
mastodon/mastodon3⭐ 48691Avoid multiple passes through the same data structure when a single iteration can accomplish the same work....
-
Network resource limits
mastodon/mastodon3⭐ 48691Implement protective limits for network operations to prevent resource exhaustion and denial-of-service att...
-
leverage existing configuration sources
mastodon/mastodon3⭐ 48691When implementing configuration logic, prefer using built-in configuration mechanisms and existing framewor...
-
Extract view complexity
mastodon/mastodon3⭐ 48691Keep views clean and readable by extracting complex logic to appropriate locations. Move database queries w...
-
Complete translatable sentences
mastodon/mastodon3⭐ 48691Use complete sentences in translatable strings rather than breaking them into fragments, even if this resul...
-
Choose appropriate exception types
mastodon/mastodon3⭐ 48691Select exception types that match method contracts and avoid surprising behavior. Methods with names like `...
-
meaningful exception handling
microsoft/markitdown3⭐ 76602Exception handling should provide meaningful feedback and use appropriate exception types rather than faili...
-
Improve documentation discoverability
microsoft/markitdown3⭐ 76602Ensure that important information about code purpose, behavior, and context is easily discoverable through ...
-
Improve code modularity
microsoft/markitdown3⭐ 76602Organize code into well-structured, reusable components by extracting specific functionality into separate ...
-
Documentation language precision
microsoft/markitdown3⭐ 76602Ensure documentation uses precise, accurate language that clearly describes functionality and highlights im...
-
Template instantiation trade-offs
maplibre/maplibre-native3⭐ 1411When designing algorithms that accept callbacks or function parameters, consider the trade-off between temp...
-
Reserve container capacity early
maplibre/maplibre-native3⭐ 1411When using containers like `unordered_map`, `unordered_set`, or vectors in performance-critical code, alway...
-
Prefer values over pointers
maplibre/maplibre-native3⭐ 1411When designing classes and interfaces, prefer passing lightweight objects by value rather than using raw po...
-
Externalize configuration values
maplibre/maplibre-native3⭐ 1411Use environment variables and external configuration mechanisms instead of hard-coding values in build scri...
-
Externalize config values
maplibre/maplibre-native3⭐ 1411Replace hardcoded "magic numbers" and environment-specific logic with externally configurable values. Use p...
-
DRY class hierarchies
maplibre/maplibre-native3⭐ 1411Follow the Don't Repeat Yourself (DRY) principle when designing class hierarchies. Extract common functiona...
-
Design evolution-ready APIs
maplibre/maplibre-native3⭐ 1411Design APIs that are both explicit in their usage and provide clear evolution paths. When designing APIs: ...
-
Cross-platform CI validation
maplibre/maplibre-native3⭐ 1411Always verify that code changes work across all CI platforms before submitting. When addressing a CI issue ...
-
Tailwind configuration patterns
logseq/logseq3⭐ 37695Follow Tailwind CSS's recommended configuration patterns to ensure proper functionality and JIT mode compat...
-
Multi-arity backward compatibility
logseq/logseq3⭐ 37695When extending existing API functions with new parameters, use multi-arity function definitions to maintain...
-
Maintain documentation consistency
logseq/logseq3⭐ 37695When modifying documentation structure or content, ensure all cross-references remain valid and avoid creat...
-
Filter nil values defensively
logseq/logseq3⭐ 37695Proactively filter out nil values from collections and validate non-empty states before processing to preve...
-
Classify configuration properties appropriately
logseq/logseq3⭐ 37695Ensure configuration properties and settings are properly categorized based on their intended use, visibili...
-
API input validation
logseq/logseq3⭐ 37695When working with APIs, always validate inputs beyond basic format checking to ensure semantic correctness ...
-
Simplify error flows
lobehub/lobe-chat3⭐ 65138Avoid complex, multi-layered error handling that obscures error origins and makes debugging difficult. Each...
-
Protect sensitive data
lobehub/lobe-chat3⭐ 65138Always identify and properly protect sensitive data fields in your code. Sensitive information includes IP ...
-
Optimize store selectors
lobehub/lobe-chat3⭐ 65138Write store selectors with proper patterns to prevent unnecessary component re-renders. Use inline selector...
-
Optimize database column types
lobehub/lobe-chat3⭐ 65138Choose appropriate data types for database columns to improve storage efficiency and performance. Use auto-...
-
Dependency version management
lobehub/lobe-chat3⭐ 65138Use semantic versioning ranges for dependencies instead of "latest" or overly broad ranges. Avoid "latest" ...
-
Consider SSR impact
lobehub/lobe-chat3⭐ 65138When using Next.js dynamic imports, carefully evaluate whether to disable server-side rendering (SSR) based...
-
Configuration merging precedence
lobehub/lobe-chat3⭐ 65138When merging configuration objects, always preserve existing values and follow clear precedence rules to av...
-
Configuration file consistency
lobehub/lobe-chat3⭐ 65138Ensure configuration values are consistent and properly coordinated across all related files (docker-compos...
-
optimize CI/CD pipelines
LMCache/LMCache3⭐ 3800CI/CD pipelines should be optimized for both performance and maintainability through strategic caching, scr...
-
Ensure metadata consistency
LMCache/LMCache3⭐ 3800Always persist metadata alongside data and implement proper checking mechanisms to prevent duplicates and e...
-
Choose efficient data structures
LMCache/LMCache3⭐ 3800Select appropriate built-in data structures and algorithmic patterns that eliminate manual checks and reduc...
-
Target-aware configuration handling
llvm/llvm-project3⭐ 33702When implementing features that depend on specific compilation targets or modes, design configuration mecha...
-
minimize test complexity
llvm/llvm-project3⭐ 33702Tests should be minimal and focused on the specific functionality being verified. Remove unnecessary passes...
-
validate configuration options explicitly
ggml-org/llama.cpp3⭐ 83559When handling configuration options or tool types, use explicit conditional statements with proper error ha...
-
systematic test coverage
ggml-org/llama.cpp3⭐ 83559When writing tests that need to cover multiple scenarios (different data types, backend capabilities, etc.)...
-
optimize algorithmic complexity
ggml-org/llama.cpp3⭐ 83559When implementing or refactoring algorithms, prioritize efficient data structures and computational approac...
-
measure algorithm performance impact
ggml-org/llama.cpp3⭐ 83559Choose algorithms based on measurable performance benefits rather than theoretical complexity advantages. S...
-
Maintain consistent naming patterns
ggml-org/llama.cpp3⭐ 83559Follow established naming conventions in the codebase and align with original source patterns while using m...
-
Choose appropriate error mechanism
ggml-org/llama.cpp3⭐ 83559Use GGML_ASSERT for early validation and programming errors that indicate misconfigurations, but implement ...
-
AI documentation precision
ggml-org/llama.cpp3⭐ 83559Ensure documentation for AI/ML tools and libraries is precise, complete, and properly formatted. This inclu...
-
Standardize environment versions
BerriAI/litellm3⭐ 28310Ensure consistent versions of languages, tools, and dependencies across all CI/CD environments (GitHub Acti...
-
Prefer lightweight observability integrations
BerriAI/litellm3⭐ 28310Observability integrations should minimize external dependencies and avoid patching LiteLLM's core function...
-
minimize core dependencies
BerriAI/litellm3⭐ 28310Keep core dependencies minimal in configuration files like pyproject.toml. Non-essential packages should be...
-
Ensure database consistency
BerriAI/litellm3⭐ 28310Maintain data consistency by using appropriate database operations and ensuring transactional integrity whe...
-
Validate environment variables strictly
langfuse/langfuse3⭐ 13574Implement comprehensive validation for environment variables using a schema validation library (e.g., Zod)....
-
Standardize configuration values
langfuse/langfuse3⭐ 13574Always standardize configuration values to ensure consistency, reproducibility, and maintainability: 1. **...
-
Semantically correct status
langfuse/langfuse3⭐ 13574Use HTTP status codes that accurately reflect the outcome of API operations. This improves API clarity and ...
-
Secure external links
langfuse/langfuse3⭐ 13574Always add `rel="noopener noreferrer"` to external links that use `target="_blank"` to prevent tabnabbing a...
-
Ensure algorithmic precision
langfuse/langfuse3⭐ 13574When implementing algorithms, ensure they perform exactly the operations needed without introducing uninten...
-
Document data constraints
langfuse/langfuse3⭐ 13574Explicitly document all input and output constraints directly in API definitions. For inputs, specify valid...
-
Database migration best practices
langfuse/langfuse3⭐ 13574When implementing database schema changes, follow these migration best practices to maintain data integrity...
-
Consistent database naming
langfuse/langfuse3⭐ 13574Maintain consistent naming patterns across all database objects. Ensure that: 1. Related object names are ...
-
Secure credential management
langflow-ai/langflow3⭐ 111046Ensure sensitive data like API keys, passwords, and encryption keys are stored securely and never exposed i...
-
observability documentation structure
langflow-ai/langflow3⭐ 111046Use proper heading hierarchy instead of bold text formatting when documenting observability features like m...
-
Handle null values safely
langflow-ai/langflow3⭐ 111046When handling potentially null or undefined values, implement explicit null checks and provide safe default...
-
eliminate code duplication
langflow-ai/langflow3⭐ 111046Identify and eliminate duplicated code by extracting shared functionality to appropriate locations. When mu...
-
Document security implications clearly
langflow-ai/langflow3⭐ 111046When documenting features that involve sensitive data, authentication, or privileged operations, explicitly...
-
Document connection parameters clearly
langflow-ai/langflow3⭐ 111046When documenting network connections (SSH, HTTP, database, etc.), provide clear explanations of all connect...
-
Consistent formatting standards
langflow-ai/langflow3⭐ 111046Maintain consistent formatting and syntax across all documentation and code examples to improve readability...
-
API endpoint documentation
langflow-ai/langflow3⭐ 111046Ensure API documentation includes all required networking components and uses proper syntax for shell comma...
-
Documentation completeness check
langchain-ai/langchainjs3⭐ 15004Ensure all documentation is complete, well-formatted, and maximally useful for developers. This includes: ...
-
Constructor over setter
langchain-ai/langchainjs3⭐ 15004Prefer passing configuration through constructor parameters rather than setting properties after instantiat...
-
Consistent naming conventions
langchain-ai/langchainjs3⭐ 15004Maintain consistent and explicit naming conventions across your codebase that reflect: 1. **Component depe...
-
Consistent AI naming
langchain-ai/langchainjs3⭐ 15004Use specific and consistent naming conventions when referencing AI services, models, and their parameters t...
-
Chunked data processing
langchain-ai/langchainjs3⭐ 15004When processing large arrays or data structures, implement chunked processing to avoid stack size limitatio...
-
AI dependency management
langchain-ai/langchainjs3⭐ 15004When integrating AI models and language processing libraries, follow these dependency management best pract...
-
Use table-driven tests
kubeflow/kubeflow3⭐ 15064In Go, prefer table-driven tests over multiple separate test functions. Table tests allow for concise testi...
-
Use snake_case in Python
kubeflow/kubeflow3⭐ 15064Follow Python's PEP 8 naming convention by using snake_case for variables, functions, and methods rather th...
-
Use appropriate log levels
kubeflow/kubeflow3⭐ 15064Always match logging levels to the message's purpose and severity. Use log.Info for general information, lo...
-
Structured OWNERS files
kubeflow/kubeflow3⭐ 15064OWNERS files must follow project documentation standards to properly reflect component ownership and mainta...
-
Standardize build configurations
kubeflow/kubeflow3⭐ 15064All components should use consistent build configurations and patterns in their CI/CD setup. This includes ...
-
Specific network access documentation
kubeflow/kubeflow3⭐ 15064When documenting network access methods or service connections, always provide specific commands with expli...
-
Normalize URL paths
kubeflow/kubeflow3⭐ 15064When handling URLs in web applications, consistently normalize path formats to prevent routing and service ...
-
Mark UI text i18n
kubeflow/kubeflow3⭐ 15064All user-facing text in HTML templates should be marked for internationalization using the i18n directive. ...
-
Manage configuration changes
kubeflow/kubeflow3⭐ 15064Carefully manage configuration file changes to ensure consistency and minimize unintended impacts across yo...
-
Environment-aware configuration design
kubeflow/kubeflow3⭐ 15064Design configurations that work consistently across different environments without requiring environment-sp...
-
Document with precision
kubeflow/kubeflow3⭐ 15064Write informative, consistent, and precise code comments throughout your codebase. When documenting code: ...
-
Check before use
kubeflow/kubeflow3⭐ 15064Always validate that objects, maps, and other reference types are non-nil before attempting to use them. Us...
-
Standardize build configurations
JetBrains/kotlin3⭐ 50857Maintain consistent and standardized build configurations across the project to improve maintainability and...
-
Handle AI provider specifics
kilo-org/kilocode3⭐ 7302Different AI providers and models have unique requirements for input processing, output filtering, and API ...
-
API header management
kilo-org/kilocode3⭐ 7302Establish consistent patterns for handling headers in API clients to avoid duplication and ensure predictab...
-
validate network state
apache/kafka3⭐ 30575Always validate network connectivity and cluster state before attempting network operations. Check for lead...
-
Validate configurations early
apache/kafka3⭐ 30575Perform comprehensive configuration validation as early as possible in the execution flow, before any state...
-
Use parameterized logging
apache/kafka3⭐ 30575Use parameterized logging with placeholders (`{}`) instead of string concatenation for better performance a...
-
Use condition-based waiting
apache/kafka3⭐ 30575Replace fixed-time delays with condition-based waiting mechanisms to ensure reliable synchronization and av...
-
sequence data state updates
apache/kafka3⭐ 30575When working with distributed data systems, ensure that state updates are performed in the correct conceptu...
-
maintain naming consistency
apache/kafka3⭐ 30575Ensure consistent naming conventions and parameter ordering throughout the codebase. This includes maintain...
-
Add proactive null checks
apache/kafka3⭐ 30575Always add null checks before accessing methods or properties on objects that can potentially be null, espe...
-
Use safe optional defaults
jj-vcs/jj3⭐ 21171When working with optional values, prefer safe extraction methods that provide defaults rather than methods...
-
Use intuitive descriptive names
jj-vcs/jj3⭐ 21171Choose names that clearly communicate purpose and intent without requiring additional documentation or cont...
-
documentation formatting consistency
jj-vcs/jj3⭐ 21171Maintain consistent formatting and style patterns across all documentation to improve readability and user ...
-
Config file naming clarity
jj-vcs/jj3⭐ 21171Use descriptive, unambiguous names for configuration files to clearly indicate their scope and prevent user...
-
Use descriptive names
menloresearch/jan3⭐ 37620Choose variable and function names that clearly communicate their purpose, type, and behavior. Names should...
-
Externalize hardcoded configurations
menloresearch/jan3⭐ 37620Avoid hardcoding configuration values like ports, URLs, API endpoints, and environment-specific settings di...
-
Eliminate filler language
menloresearch/jan3⭐ 37620Remove unnecessary filler words and repetitive phrases that dilute clarity and assume reader incompetence. ...
-
Configuration structure clarity
menloresearch/jan3⭐ 37620Ensure configuration parameters are properly structured, accurately documented, and clearly indicate their ...
-
Concise documentation writing
menloresearch/jan3⭐ 37620Write documentation that respects user intelligence by being concise and avoiding over-explanation of obvio...
-
maintain consistent naming patterns
istio/istio3⭐ 37192Ensure naming consistency across related components and throughout the codebase to prevent developer confus...
-
leverage kernel network structures
istio/istio3⭐ 37192When implementing eBPF networking programs, prefer using kernel-native data structures and BPF helpers over...
-
Early nil checks
istio/istio3⭐ 37192Add nil and empty checks at the beginning of functions to prevent downstream issues and avoid unnecessary p...
-
consistent log formatting
istio/istio3⭐ 37192Maintain consistent formatting conventions across log messages to improve code readability and debugging ef...
-
Configuration documentation standards
istio/istio3⭐ 37192Ensure all user-configurable options are properly documented and discoverable, while keeping configuration ...
-
avoid timing dependencies
istio/istio3⭐ 37192Eliminate timing dependencies in tests by using proper retry mechanisms and assertions instead of sleep sta...
-
avoid repeated expensive operations
istio/istio3⭐ 37192Avoid performing expensive computational operations repeatedly when the same result can be achieved through...
-
Use descriptive variable names
vadimdemedes/ink3⭐ 31825Avoid single-character variables and abbreviations in favor of descriptive, full-word names that clearly co...
-
Use descriptive names
vadimdemedes/ink3⭐ 31825Choose variable, function, and export names that clearly communicate their purpose and content. Avoid abbre...
-
Provide clear documentation context
vadimdemedes/ink3⭐ 31825Documentation should include practical context, clear explanations, and appropriate examples to help users ...
-
Fix linting root causes
vadimdemedes/ink3⭐ 31825Address underlying code issues rather than disabling linting rules or working around auto-formatter conflic...
-
explicit type checking
vadimdemedes/ink3⭐ 31825Always perform explicit type and existence checks before operations that could fail with null or undefined ...
-
Consistent code formatting
vadimdemedes/ink3⭐ 31825Maintain consistent formatting and alignment throughout the codebase to improve readability and maintainabi...
-
Type over primitives
influxdata/influxdb3⭐ 30268Use domain-specific types instead of primitives (like strings, []byte, or generic maps) to represent domain...
-
Secure token lifecycle
influxdata/influxdb3⭐ 30268Implement comprehensive lifecycle controls for authentication tokens to maintain security throughout token ...
-
Explicit security parameters
influxdata/influxdb3⭐ 30268Security-critical features should be implemented as required parameters rather than optional parameters or ...
-
Document complete data flows
influxdata/influxdb3⭐ 30268When documenting database systems, ensure all documentation includes complete end-to-end data flows. Both d...
-
Complete schema management
influxdata/influxdb3⭐ 30268When working with database systems that have flexible schemas (like InfluxDB), ensure complete schema disco...
-
Sanitize external content
elie222/inbox-zero3⭐ 8267Always sanitize and validate external content before processing or rendering it to prevent security vulnera...
-
Remove commented out code
elie222/inbox-zero3⭐ 8267Delete commented-out code instead of retaining it in the codebase. Commented code creates confusion, adds m...
-
Next.js async behavior
elie222/inbox-zero3⭐ 8267Understand and correctly implement the asynchronous behavior of Next.js APIs and components. Follow these g...
-
Guard against null chains
elie222/inbox-zero3⭐ 8267Prevent null pointer exceptions by validating object chains before accessing nested properties. Use early r...
-
Externalize configuration values
elie222/inbox-zero3⭐ 8267Configuration files should not contain hardcoded values for usernames, credentials, hostnames, or environme...
-
Database type best practices
elie222/inbox-zero3⭐ 8267Select appropriate data types and defaults for database columns to ensure data integrity and simplify appli...
-
optimize with bit manipulation
hyprwm/Hyprland3⭐ 28863Use bit manipulation techniques to optimize memory usage and computational efficiency in data structures an...
-
configuration consistency validation
hyprwm/Hyprland3⭐ 28863When modifying configuration options, ensure changes are consistently applied across all relevant locations...
-
API identifier consistency
juspay/hyperswitch3⭐ 34028Maintain consistent naming conventions for API identifiers, configuration keys, and payment method types. U...
-
Use realistic doc examples
helix-editor/helix3⭐ 39026Documentation should include concrete, realistic examples that demonstrate practical usage rather than abst...
-
Semantic identifier naming patterns
helix-editor/helix3⭐ 39026Use consistent naming patterns that reflect the semantic role of identifiers: 1. Constants should use UPPE...
-
Optimize query performance
helix-editor/helix3⭐ 39026When writing tree-sitter queries, prioritize performance by choosing efficient predicates and avoiding comp...
-
Documentation style and formatting
helix-editor/helix3⭐ 39026Maintain consistent documentation style by following these guidelines: 1. Use concise, descriptive languag...
-
avoid version-specific documentation
helix-editor/helix3⭐ 39026When writing build and deployment documentation, avoid hard-coding specific version numbers, toolchain assu...
-
Proper mocking techniques
grafana/grafana3⭐ 68825Use appropriate mocking approaches for different dependencies in tests to ensure accurate test results and ...
-
Optimize hot paths
grafana/grafana3⭐ 68825Identify and optimize frequently executed code paths by moving invariant calculations and conditional logic...
-
Measure before optimizing
grafana/grafana3⭐ 68825Performance optimizations should be validated with measurements rather than assumptions. When implementing ...
-
Maintain API version compatibility
grafana/grafana3⭐ 68825When implementing or modifying APIs, ensure backward compatibility across versions and client interfaces. C...
-
Graceful feature availability
grafana/grafana3⭐ 68825When implementing configurable features, ensure they degrade gracefully based on environment conditions lik...
-
Feature toggle lifecycle
grafana/grafana3⭐ 68825When working with feature toggles and configuration flags, manage their entire lifecycle carefully to preve...
-
Design token value consistency
grafana/grafana3⭐ 68825When implementing design tokens in code, ensure values accurately represent the intended visual outcome, ev...
-
Complete configuration fields
grafana/grafana3⭐ 68825Ensure all plugin configuration files include the complete set of required fields specific to their plugin ...
-
Use idiomatic optional patterns
block/goose3⭐ 19037Prefer Rust's built-in optional handling methods over manual checks and intermediate variables. Use `if let...
-
Optimize hook dependencies
block/goose3⭐ 19037Understand React's built-in optimizations and avoid unnecessary dependencies in hook arrays. React guarante...
-
extract duplicated code
block/goose3⭐ 19037Identify and eliminate code duplication by extracting shared logic into reusable functions, components, or ...
-
Environment-aware configuration handling
block/goose3⭐ 19037Use environment variables to control application behavior and ensure configuration changes are properly syn...
-
Document non-obvious code
block/goose3⭐ 19037Add clear documentation for code elements that aren't immediately self-explanatory to improve readability a...
-
default least permissive
block/goose3⭐ 19037When implementing security controls, always default to the most restrictive option and require explicit opt...
-
Use benchmarked thresholds
golang/go3⭐ 129599Base performance-critical constants, limits, and thresholds on empirical benchmarking rather than arbitrary...
-
Go module configuration
golang/go3⭐ 129599Ensure Go projects use modern module configuration instead of legacy GOPATH setup. Projects should be creat...
-
Write resilient tests
gin-gonic/gin3⭐ 83022Tests should be designed to validate behavior without being brittle or sensitive to implementation details....
-
Use standard API constants
gin-gonic/gin3⭐ 83022Always use standard library constants for HTTP methods and status codes rather than string literals or nume...
-
Precompute over recalculate
gin-gonic/gin3⭐ 83022Perform expensive calculations during initialization rather than on each request, and avoid unnecessary ope...
-
Early return pattern
gin-gonic/gin3⭐ 83022Prefer returning early from functions rather than nesting conditions. When a condition can lead to an early...
-
Configuration file precision
gin-gonic/gin3⭐ 83022Ensure configuration files are precisely maintained with correct syntax and compatible version declarations...
-
Prefer safe optional handling
ghostty-org/ghostty3⭐ 32864Always use Swift's built-in mechanisms for safely handling optional values instead of force unwrapping or m...
-
Encapsulate implementation details
ghostty-org/ghostty3⭐ 32864When designing APIs, create appropriate abstractions that hide platform-specific or low-level implementatio...
-
Define explicit error sets
ghostty-org/ghostty3⭐ 32864Always define explicit error sets for functions that can fail, rather than using inferred error sets. This ...
-
Centralize configuration values
ghostty-org/ghostty3⭐ 32864Hardcoded configuration values scattered throughout codebases create maintenance burdens and increase the r...
-
Centralize configuration management
ghostty-org/ghostty3⭐ 32864Avoid hardcoded or duplicated configuration values by centralizing them in a dedicated location. When confi...
-
Remove unsupported runtime versions
google-gemini/gemini-cli3⭐ 65062When maintaining CI/CD pipelines, regularly audit and remove runtime versions that are no longer supported ...
-
Prevent React race conditions
google-gemini/gemini-cli3⭐ 65062When building React components that handle rapid user input or manage complex interdependent state, consoli...
-
Maintain consistent naming
google-gemini/gemini-cli3⭐ 65062Ensure naming consistency across all contexts where an identifier appears - configuration files, code enums...
-
Document configuration defaults clearly
google-gemini/gemini-cli3⭐ 65062When documenting configuration options, always specify exact file paths, explicit default values, and clari...
-
Thread safety synchronization
flutter/flutter3⭐ 172252Ensure proper synchronization when accessing shared data structures and coordinate operations across multip...
-
preserve error context
firecrawl/firecrawl3⭐ 54535Always maintain complete error information when logging or re-throwing errors to enable effective debugging...
-
Validate security inputs
gofiber/fiber3⭐ 37560Always validate security-critical inputs to prevent DoS attacks and injection vulnerabilities. Implement si...
-
Update documentation proactively
gofiber/fiber3⭐ 37560When code behavior changes, new features are added, or potential usage pitfalls are identified, proactively...
-
Prefer standard library functions
gofiber/fiber3⭐ 37560When implementing algorithms, prioritize using standard library functions over manual implementations when ...
-
maintain clean linter configs
gofiber/fiber3⭐ 37560Ensure linter configuration files are well-maintained by avoiding duplicate entries, using current non-depr...
-
explicit CI/CD configuration
gofiber/fiber3⭐ 37560Always use explicit configuration in CI/CD workflows rather than relying on defaults or convenience shortcu...
-
Enforce secure TLS configuration
gofiber/fiber3⭐ 37560Always configure TLS connections with secure minimum version requirements and proper certificate handling. ...
-
Clear network API documentation
gofiber/fiber3⭐ 37560Ensure networking-related API documentation and descriptions are specific, clear, and include concrete impl...
-
Choose descriptive property names
gofiber/fiber3⭐ 37560Property and configuration field names should clearly communicate their purpose, behavior, and relationship...
-
Consistent Fastify Integration Patterns
fastify/fastify3⭐ 34000When implementing integrations and plugins using the Fastify framework, maintain consistent coding patterns...
-
Standardize version transitions
fastapi/fastapi3⭐ 86871When supporting multiple library versions or preparing for version deprecation in configuration-dependent c...
-
Secure JWT authentication
fastapi/fastapi3⭐ 86871Implement secure authentication using JWT tokens by following these best practices: 1. **Use secure librar...
-
Proper response handling
fastapi/fastapi3⭐ 86871When designing APIs, ensure responses adhere to HTTP semantics by: 1. Using semantic status code constants...
-
Preserve unset field values
fastapi/fastapi3⭐ 86871When implementing partial updates in FastAPI, use the `exclude_unset` parameter in Pydantic's `.dict()` or ...
-
Explicit exception propagation
fastapi/fastapi3⭐ 86871Always be explicit about how exceptions are handled, propagated, and recovered from in your code. When catc...
-
Structured release workflows
expressjs/express3⭐ 67300Implement a clearly defined release strategy that distinguishes between different types of changes. Create ...
-
Purposeful style changes
expressjs/express3⭐ 67300Code style modifications should accompany functional improvements rather than being submitted as standalone...
-
Implement least privilege
expressjs/express3⭐ 67300Apply the principle of least privilege for all repository and system access to enhance security. Each role ...
-
verify platform network compatibility
evanw/esbuild3⭐ 39161When adding support for new platforms or architectures, thoroughly verify that networking functionality wor...
-
validate external input safely
electron/electron3⭐ 117644Always validate and sanitize external input using established libraries rather than manual string manipulat...
-
Use semantically accurate names
electron/electron3⭐ 117644Choose parameter and method names that accurately reflect their semantic meaning and implementation reality...
-
organize code structure
electron/electron3⭐ 117644Make deliberate structural decisions that improve code maintainability and readability. Consider the approp...
-
Document error handling limitations
electron/electron3⭐ 117644When documenting error handling mechanisms, always provide complete context about how they work, including ...
-
defensive null checking
electron/electron3⭐ 117644Implement robust null and undefined handling patterns to prevent runtime errors and maintain code reliabili...
-
Context-aware module loading
electron/electron3⭐ 117644Choose appropriate module loading syntax based on your execution context and build configuration settings. ...
-
async destruction safety
electron/electron3⭐ 117644When destroying objects asynchronously to avoid crashes from observer notifications or other synchronous de...
-
Stage intensive operations carefully
elastic/elasticsearch3⭐ 73104When implementing operations that consume significant system resources (CPU, memory, I/O), introduce change...
-
Scope and document configurations
elastic/elasticsearch3⭐ 73104When designing and implementing configuration options, carefully consider two key aspects: 1. **Choose app...
-
Design for evolution
elastic/elasticsearch3⭐ 73104When designing APIs, prioritize flexibility and independent evolution of components. Avoid tightly coupling...
-
Simplify and organize code
dyad-sh/dyad3⭐ 16903Keep code simple, direct, and well-organized by avoiding unnecessary complexity and properly structuring co...
-
use default serialization methods
duckdb/duckdb3⭐ 32061When adding new properties to serialization methods, use `WritePropertyWithDefault` and `ReadPropertyWithDe...
-
thoughtful configuration design
duckdb/duckdb3⭐ 32061When designing configuration options, environment variables, and build settings, follow established pattern...
-
Maintain consistent naming patterns
duckdb/duckdb3⭐ 32061Ensure all new functions, files, and identifiers follow established naming conventions within the codebase....
-
Guard expensive logging operations
duckdb/duckdb3⭐ 32061Avoid executing expensive operations in logging code paths when logging is disabled or not needed. Always c...
-
generate test data dynamically
duckdb/duckdb3⭐ 32061Instead of adding static test data files to the repository, generate test data programmatically within test...
-
Environment variable handling
duckdb/duckdb3⭐ 32061When working with environment variables, follow consistent naming conventions, properly check for their pre...
-
avoid redundant lookups
duckdb/duckdb3⭐ 32061When working with associative containers (sets, maps, unordered_set, unordered_map), avoid performing redun...
-
preserve thread-local state
stanfordnlp/dspy3⭐ 27813When launching threads in DSPy, ensure that child threads inherit the parent thread's local overrides to ma...
-
Cache key serialization
stanfordnlp/dspy3⭐ 27813When implementing caching for functions that accept complex objects (dictionaries with mixed types, Pydanti...
-
optimize algorithmic performance
drizzle-team/drizzle-orm3⭐ 29461Prioritize algorithmic efficiency and avoid unnecessary computational overhead, especially in type-level op...
-
Validate configuration changes
django/django3⭐ 84182Before modifying default configuration settings, thoroughly understand and test their implications. Django'...
-
Transaction-aware task enqueuing
django/django3⭐ 84182When working with background tasks that depend on database changes, ensure tasks are enqueued only after th...
-
Prefer semantic CSS selectors
django/django3⭐ 84182Use semantic attribute-based selectors instead of structural or overly specific class names when the semant...
-
Feature flags over vendors
django/django3⭐ 84182When checking for database backend capabilities, always use feature flags rather than checking specific ven...
-
Fail predictably, loudly
django/django3⭐ 84182Design APIs that fail explicitly and predictably when used incorrectly. When an operation is attempted in a...
-
Document accessibility decisions
django/django3⭐ 84182When implementing HTML templates, add clear comments documenting accessibility-related decisions. Explain t...
-
Break lines for readability
django/django3⭐ 84182Format code with semantic line breaks that enhance readability rather than adhering strictly to character l...
-
Async resource cleanup guarantees
django/django3⭐ 84182When implementing async context managers, always ensure proper resource cleanup even during task cancellati...
-
Validate configuration dependencies
discourse/discourse3⭐ 44898Configuration settings often depend on other settings or external resources to function correctly. Always i...
-
Safe configuration access
discourse/discourse3⭐ 44898Always verify configuration properties exist before accessing them to prevent runtime errors. Configuration...
-
prefer CSS custom properties
discourse/discourse3⭐ 44898Use CSS custom properties (CSS variables) instead of hardcoded values for fonts, spacing, colors, and other...
-
Include contextual error information
discourse/discourse3⭐ 44898Error messages should include relevant contextual information such as IDs, file paths, job identifiers, and...
-
CSS modifier naming
discourse/discourse3⭐ 44898Use consistent modifier patterns with `--` prefixes for CSS classes and variables. Prefer semantic base nam...
-
Cache expensive operations
discourse/discourse3⭐ 44898Identify and eliminate duplicate computations by caching results of expensive operations. This includes mem...
-
avoid underscore prefixes
discourse/discourse3⭐ 44898Do not use underscore prefixes (`_`) for private or internal methods and properties. The team consensus is ...
-
Avoid optimization anti-patterns
discourse/discourse3⭐ 44898Identify and eliminate code patterns that appear to be performance optimizations but actually hurt performa...
-
Optimize data structures
langgenius/dify3⭐ 114231Choose appropriate built-in data structures and collection types to improve code efficiency and readability...
-
Maintain consistent organization
langgenius/dify3⭐ 114231Ensure proper file organization and consistent import conventions throughout the codebase. Assets should be...
-
Ensure configuration consistency
langgenius/dify3⭐ 114231Maintain consistency across configuration variables to prevent setup confusion and deployment issues. Avoid...
-
Conservative configuration management
langgenius/dify3⭐ 114231Be selective and intentional with configuration choices to avoid bloat and unnecessary complexity. This app...
-
Configuration defaults appropriateness
langgenius/dify3⭐ 114231Ensure configuration parameters have appropriate default values and avoid hardcoded or overly specific sett...
-
Choose descriptive, unambiguous names
langgenius/dify3⭐ 114231Select variable, method, and property names that clearly communicate their purpose and avoid ambiguity. Pri...
-
Balance CI/CD trade-offs
langgenius/dify3⭐ 114231When configuring CI/CD pipelines, balance comprehensive coverage and security with practical constraints li...
-
Lazy initialization patterns
zen-browser/desktop3⭐ 34711Avoid repeatedly performing expensive operations like adding event handlers, loading resources, or fetching...
-
Use descriptive identifiers
denoland/deno3⭐ 103714Choose names that clearly communicate the purpose, functionality, and usage context of variables, methods, ...
-
Use backticks for identifiers
denoland/deno3⭐ 103714Wrap all code identifiers, method names, interface names, class names, and API references in JSDoc comments...
-
network address validation
denoland/deno3⭐ 103714When validating network addresses and interfaces, properly handle special address values and use protocol-s...
-
Explain non-obvious decisions
denoland/deno3⭐ 103714When code contains non-obvious parameter choices, conditional logic, or unexpected implementation changes, ...
-
environment loading order
denoland/deno3⭐ 103714Environment files and variables must be loaded before creating any factories, services, or components that ...
-
Document network APIs comprehensively
denoland/deno3⭐ 103714Network APIs and interfaces should include comprehensive documentation with clear descriptions, practical e...
-
Control cache lifecycle
denoland/deno3⭐ 103714Design cache systems so that higher-level components control when cache entries are invalidated or cleaned ...
-
Choose appropriate algorithms
denoland/deno3⭐ 103714When implementing functionality, carefully evaluate different algorithmic approaches and data structures to...
-
Add comprehensive test coverage
denoland/deno3⭐ 103714Ensure that all functionality, especially complex or quirky features, has corresponding unit tests. When ad...
-
Configuration parameter validation
bytedance/deer-flow3⭐ 16482Always validate configuration parameters for type, range, and reasonable values before use. Provide safe de...
-
Use appropriate logging levels
deeplearning4j/deeplearning4j3⭐ 14036Reserve logging statements for their appropriate purposes and levels. Use debugging-level logs (`sd_debug`)...
-
Parameterize configuration scripts
deeplearning4j/deeplearning4j3⭐ 14036Configuration scripts should use variables for values that might change or are used in multiple places, suc...
-
Eliminate redundant code
deeplearning4j/deeplearning4j3⭐ 14036Keep code clean by removing all forms of redundancy that affect readability and maintainability. This inclu...
-
Clear descriptive identifiers
deeplearning4j/deeplearning4j3⭐ 14036Choose clear, self-descriptive names for all code identifiers that accurately reflect their purpose and beh...
-
Avoid environment-specific paths
deeplearning4j/deeplearning4j3⭐ 14036Always use environment variables or configuration mechanisms instead of hardcoding paths to compilers, tool...
-
Always secure your locks
deeplearning4j/deeplearning4j3⭐ 14036When using locks or other synchronization mechanisms in concurrent code, always release locks in a finally ...
-
Use exact dependency versions
cypress-io/cypress3⭐ 48850Always specify exact dependency versions in package.json files instead of using version ranges (^, ~) to en...
-
structured debug logging
cypress-io/cypress3⭐ 48850Use structured logging with object notation instead of string interpolation for debug messages to improve r...
-
Prefer semantic test selectors
cypress-io/cypress3⭐ 48850When writing tests, prioritize semantic and accessibility-based selectors over data attributes or generic s...
-
Informative error messages
cypress-io/cypress3⭐ 48850Error messages should be informative and include the actual values that caused the problem, not just generi...
-
Extract inline code
cypress-io/cypress3⭐ 48850Extract complex inline code elements into separate functions, components, or constants to improve readabili...
-
Consistent naming patterns
cypress-io/cypress3⭐ 48850Establish and enforce consistent naming conventions across different contexts in your codebase. Teams shoul...
-
Clarify testing documentation
cypress-io/cypress3⭐ 48850Ensure that testing documentation, including changelogs, API docs, and guides, uses clear and precise langu...
-
Validate configurations up front
crewaiinc/crewai3⭐ 33945Always validate configuration parameters and environment variables at initialization time, providing clear ...
-
Typed API client abstractions
crewaiinc/crewai3⭐ 33945When designing API clients, encapsulate responses in typed objects rather than passing raw JSON throughout ...
-
Thread safety first
crewaiinc/crewai3⭐ 33945When implementing features that may run concurrently, always ensure thread safety using appropriate synchro...
-
Test behavior not calls
crewaiinc/crewai3⭐ 33945Tests should validate actual system behavior rather than just verifying method calls. When writing tests, f...
-
Explicit over implicit
crewaiinc/crewai3⭐ 33945Always explicitly configure important system components rather than relying on implicit defaults or environ...
-
Clear AI component interfaces
crewaiinc/crewai3⭐ 33945When designing AI components and tools, use domain-specific terminology and provide clear interface documen...
-
Vue component type safety
vuejs/core3⭐ 50769When defining Vue components with TypeScript, use appropriate component definition patterns to ensure prope...
-
Use environment flags consistently
vuejs/core3⭐ 50769Feature flags like `__DEV__` and `__COMPAT__` are critical configuration mechanisms that control environmen...
-
Use configuration constants
home-assistant/core3⭐ 80450Always use predefined constants from `homeassistant.const` instead of string literals when accessing config...
-
Use asyncio.gather concurrency
home-assistant/core3⭐ 80450When performing multiple independent async operations, use `asyncio.gather()` to execute them concurrently ...
-
Lifecycle effects management
vuejs/core3⭐ 50769Properly manage component lifecycle effects and cleanup in React components to prevent memory leaks and per...
-
configuration status accuracy
home-assistant/core3⭐ 80450Ensure that configuration file status values accurately reflect the actual implementation state. Use 'done'...
-
API polling optimization
home-assistant/core3⭐ 80450Optimize API polling patterns to avoid excessive calls and improve performance. Use appropriate update inte...
-
Use established configuration patterns
continuedev/continue3⭐ 27819Always access and set configuration values using established patterns and correct property names. Understan...
-
Tests must assert
continuedev/continue3⭐ 27819Test methods should contain active, uncommented code that includes at least one assertion to verify expecte...
-
Standardize LLM configurations
continuedev/continue3⭐ 27819When configuring LLM providers and their capabilities, always use proper JSON syntax with quoted property n...
-
Smart model selection
continuedev/continue3⭐ 27819Implement intelligent model selection mechanisms that adapt to different scenarios instead of hardcoding sp...
-
Memoize expensive calculations
continuedev/continue3⭐ 27819Cache computation results in React components to prevent unnecessary recalculations during re-renders, whic...
-
Include concrete examples
continuedev/continue3⭐ 27819Technical documentation should always include concrete, working examples that demonstrate the described con...
-
Enforce strict config schemas
continuedev/continue3⭐ 27819Configuration schemas should explicitly define all required fields and validate types at compile time to pr...
-
Document configurations completely
continuedev/continue3⭐ 27819Ensure configuration documentation is comprehensive, clear and actionable for developers. This includes: 1...
-
Complete dependency arrays
continuedev/continue3⭐ 27819Always include all referenced variables in React hook dependency arrays (useEffect, useCallback, useMemo). ...
-
Validate before value use
docker/compose3⭐ 35858Always validate potentially null or empty values before use, and provide explicit default values when handl...
-
specific defensive error handling
docker/compose3⭐ 35858Implement specific exception handling and defensive programming practices to prevent generic errors from ma...
-
Schema changes upstream first
docker/compose3⭐ 35858When modifying configuration schemas, always propose changes to the upstream/source repository first before...
-
Safe collection modification
docker/compose3⭐ 35858When modifying collections during iteration, use safe patterns to avoid subtle bugs and undefined behavior....
-
prefer explicit readability
docker/compose3⭐ 35858Choose explicit, readable code constructs over "clever" or overly complex ones. Complex functional programm...
-
Pin build dependency versions
docker/compose3⭐ 35858Always pin specific versions for build dependencies and tools to prevent unexpected build failures, even wh...
-
Network API precision
docker/compose3⭐ 35858Use the appropriate Docker network API method based on the specific behavior you need. NetworkList and Netw...
-
Maintain documentation consistency
docker/compose3⭐ 35858Ensure consistent terminology, precise language, and uniform formatting throughout all documentation to imp...
-
Environment variable safety
docker/compose3⭐ 35858Always use `os.environ.get()` instead of direct dictionary access when reading environment variables to avo...
-
CI security boundaries
docker/compose3⭐ 35858Maintain strict security boundaries in CI/CD workflows by treating CI as a validation-only system and caref...
-
avoid mutable defaults
docker/compose3⭐ 35858Never use mutable objects (lists, dictionaries, sets) as default parameter values in function definitions. ...
-
avoid CI resource conflicts
docker/compose3⭐ 35858Design CI workflows to prevent resource conflicts when multiple builds run concurrently on shared infrastru...
-
Prevent path traversal
comfyanonymous/ComfyUI3⭐ 83726Always validate and sanitize file paths from user input to prevent directory traversal attacks. Malicious a...
-
Optimize cache key design
comfyanonymous/ComfyUI3⭐ 83726Design cache keys to avoid performance pitfalls and ensure reliable cache behavior. Cache keys should be li...
-
Environment variable consistency
comfyanonymous/ComfyUI3⭐ 83726Ensure consistent formatting and proper usage of environment variables in Dockerfiles. Remove unnecessary q...
-
Propagate errors appropriately
openai/codex3⭐ 31275Allow errors to bubble up to their appropriate handling layers rather than catching them prematurely. Catch...
-
Extract reusable logic
openai/codex3⭐ 31275Avoid duplicating logic across the codebase. Instead, extract common functionality into well-named helper f...
-
Avoid unnecessary operations
openai/codex3⭐ 31275Optimize performance by eliminating operations that don't contribute meaningful value to your code's functi...
-
validate untrusted inputs
cline/cline3⭐ 48299Always validate and sanitize untrusted inputs to prevent injection attacks and security vulnerabilities. Th...
-
validate configuration values
cline/cline3⭐ 48299Always verify configuration values against official documentation and test across target platforms before c...
-
validate algorithmic correctness
cline/cline3⭐ 48299Always verify algorithms work correctly across edge cases and boundary conditions through concrete examples...
-
Use theme-based styling
cline/cline3⭐ 48299Always use CSS custom properties (CSS variables) for colors and include proper accessibility attributes ins...
-
Set evidence-based timeouts
cline/cline3⭐ 48299Configure timeout values based on empirical testing and user experience requirements rather than arbitrary ...
-
Provide configuration fallbacks
cline/cline3⭐ 48299Always provide sensible default or fallback values for configuration properties to prevent undefined states...
-
prevent unnecessary operations
cline/cline3⭐ 48299Identify and eliminate redundant computations, network requests, and re-renders in React components to impr...
-
Prevent async race conditions
cline/cline3⭐ 48299Identify and prevent race conditions in asynchronous operations, especially when operations depend on each ...
-
AI provider naming clarity
cline/cline3⭐ 48299Use specific, unambiguous names for AI providers and models to prevent confusion when working with multiple...
-
Verify database state changes
ClickHouse/ClickHouse3⭐ 42425When testing database operations that modify schema, data, or metadata, always add comprehensive assertions...
-
validate user inputs
ClickHouse/ClickHouse3⭐ 42425Always validate and properly escape user-controlled input before incorporating it into structured data form...
-
Validate before unsafe operations
ClickHouse/ClickHouse3⭐ 42425Always validate values before performing operations that could result in undefined behavior, particularly d...
-
prefer simple optimizations
ClickHouse/ClickHouse3⭐ 42425When implementing performance optimizations, favor simple, straightforward approaches over complex solution...
-
Documentation completeness standards
ClickHouse/ClickHouse3⭐ 42425Ensure all documentation meets completeness and formatting standards. This includes: (1) Adding language sp...
-
Document mutex responsibilities
ClickHouse/ClickHouse3⭐ 42425Use Thread Safety Analysis (TSA) annotations to explicitly document which mutexes protect which variables, ...
-
Consistent naming conventions
ClickHouse/ClickHouse3⭐ 42425Maintain consistent naming conventions within your codebase, even when external specifications or APIs use ...
-
consistent formatting rules
ClickHouse/ClickHouse3⭐ 42425Maintain consistent formatting throughout the codebase to improve readability and maintainability. This inc...
-
Avoid duplicate HTTP headers
ClickHouse/ClickHouse3⭐ 42425Ensure HTTP headers are sent only once per response to prevent network protocol violations and connection e...
-
Validate security configurations
snyk/cli3⭐ 5178Always validate security-related configurations and implementations to ensure they follow established secur...
-
validate environment variables early
snyk/cli3⭐ 5178Environment variables should be validated early in the application lifecycle with descriptive, actionable e...
-
synchronize configuration values
snyk/cli3⭐ 5178Ensure configuration values remain consistent and aligned across all related files, environments, and syste...
-
optimize CI resource allocation
snyk/cli3⭐ 5178Match CI/CD resource allocation to actual job requirements rather than using oversized configurations globa...
-
defensive shell script configuration
snyk/cli3⭐ 5178Configure shell scripts with defensive practices to ensure reliability and debuggability. Use appropriate `...
-
Configuration naming consistency
snyk/cli3⭐ 5178Ensure configuration elements (environment variables, feature flags, config files) maintain consistent nami...
-
Balance concurrent operations
snyk/cli3⭐ 5178When implementing concurrent operations, carefully balance performance gains with resource consumption and ...
-
Standardize shell flags
chef/chef3⭐ 7860Always use `set -eou pipefail` at the beginning of shell scripts to ensure consistent error handling and be...
-
Remove commented code
chef/chef3⭐ 7860Avoid leaving commented-out code in the codebase. Version control systems already track the history of chan...
-
Fail fast principle
chef/chef3⭐ 7860Design CI/CD pipelines to fail quickly and visibly rather than masking errors through excessive retries or ...
-
Clear abstraction boundaries
chef/chef3⭐ 7860Design APIs with clear and consistent abstraction boundaries to maintain code quality and prevent interface...
-
Validate configurations correctly
bridgecrewio/checkov3⭐ 7668When writing validation logic for configurations, ensure you're using the appropriate operators that correc...
-
Support all target environments
bridgecrewio/checkov3⭐ 7667When managing dependency configurations (Pipfiles, requirements.txt, lock files), ensure compatibility with...
-
Comprehensive security scanning
bridgecrewio/checkov3⭐ 7667Always configure security scanning tools with comprehensive coverage and readable output to maximize vulner...
-
Backward compatible parameters
bridgecrewio/checkov3⭐ 7667When evolving API function signatures, maintain backward compatibility by making new parameters optional wi...
-
validate business logic constraints
calcom/cal.com3⭐ 37732Before adding database constraints or designing schema relationships, thoroughly understand the underlying ...
-
Keep API handlers thin
calcom/cal.com3⭐ 37732API handlers should be lightweight and focused on request/response handling, not business logic. Extract sp...
-
Favor component composition
calcom/cal.com3⭐ 37732Design components to be configurable through props rather than relying on external context like URL paths o...
-
Contextual error responses
calcom/cal.com3⭐ 37732Choose error response strategies based on the error's origin, caller context, and downstream impact rather ...
-
comprehensive security checks
calcom/cal.com3⭐ 37732Ensure that security checks for authorization, authentication, and information disclosure are comprehensive...
-
Avoid nested ternaries
calcom/cal.com3⭐ 37732Avoid using nested ternary operators as they significantly reduce code readability and make debugging diffi...
-
Avoid hardcoded configuration values
calcom/cal.com3⭐ 37732Extract hardcoded configuration values into constants, environment variables, or function parameters to imp...
-
Verify assertions properly
oven-sh/bun3⭐ 79093Ensure test assertions correctly validate the intended behavior by: 1. **Awaiting promise assertions** whe...
-
Technical documentation accuracy
oven-sh/bun3⭐ 79093Documentation must precisely reflect the current state of the codebase to prevent confusion and ensure deve...
-
Respect existing configurations
oven-sh/bun3⭐ 79093When integrating with external services or tools, design your configuration options to respect users' exist...
-
Never swallow errors
oven-sh/bun3⭐ 79093Always ensure errors are properly surfaced rather than silently ignored. Silent error handling can lead to ...
-
Maintain portable config values
oven-sh/bun3⭐ 79093Always use portable, environment-agnostic values in configuration files. Avoid hardcoded absolute paths, sy...
-
Deterministic lock management
oven-sh/bun3⭐ 79093Always ensure locks are acquired and released in a deterministic manner in concurrent code. Use `defer` sta...
-
validate file inputs
browser-use/browser-use3⭐ 69139All file-related operations must implement comprehensive input validation and sanitization to prevent path ...
-
Simplify algorithmic approaches
browser-use/browser-use3⭐ 69139When implementing functionality, evaluate whether simpler algorithmic approaches or more appropriate data s...
-
Safe attribute access
browser-use/browser-use3⭐ 69139Always use defensive programming patterns when accessing object attributes, especially when dealing with op...
-
Replace polling with events
browser-use/browser-use3⭐ 69139Replace busy-wait polling loops with event-driven async patterns using asyncio.Event() or similar synchroni...
-
Pin testing dependency versions
browser-use/browser-use3⭐ 69139Always specify explicit versions for testing frameworks and tools to ensure reproducible test environments ...
-
optimize Docker layers
browser-use/browser-use3⭐ 69139Avoid unnecessary duplication and bloat in Docker layers by trusting base images to provide standard tools ...
-
Consistent terminology usage
browser-use/browser-use3⭐ 69139Maintain consistent terminology and naming patterns throughout the codebase to avoid confusion and future c...
-
Use ASCII-only URLs
Homebrew/brew3⭐ 44168URLs in code should exclusively use ASCII characters for maximum security and compatibility. This prevents ...
-
Structure test fixtures clearly
Homebrew/brew3⭐ 44168Test fixtures should clearly separate input parameters from expected outputs to enhance readability and mai...
-
Secure API URL parsing
Homebrew/brew3⭐ 44168When parsing API endpoint URLs, implement rigorous input validation using precise regular expressions. This...
-
Prevent injection vulnerabilities
Homebrew/brew3⭐ 44168Always sanitize input data before using it in sensitive operations to prevent injection vulnerabilities. Th...
-
Fail with messages
Homebrew/brew3⭐ 44168Functions and scripts should never fail silently. When detecting error conditions, always provide clear err...
-
Environment variable safety
Homebrew/brew3⭐ 44168When configuring environment variables, especially those related to paths, implement these safety practices...
-
Document non-obvious decisions
Homebrew/brew3⭐ 44168Always add clear comments explaining non-obvious code decisions such as magic numbers, arbitrary values, tr...
-
Document CI pipeline comprehensively
Homebrew/brew3⭐ 44168Ensure CI/CD pipeline documentation accurately reflects the complete workflow, including job dependencies, ...
-
Manage test environments
boto/boto33⭐ 9417When writing tests that interact with environment variables or configuration settings, always (1) preserve ...
-
Demonstrate canonical API patterns
boto/boto33⭐ 9417Always provide examples that demonstrate the recommended and most current API usage patterns. This includes...
-
Consistent naming standards
boto/boto33⭐ 9417Follow standard Python naming conventions consistently throughout code and documentation. Use underscores i...
-
Use descriptive naming
better-auth/better-auth3⭐ 19651Choose specific, contextual names over generic terms to improve code clarity and maintainability. Generic n...
-
comprehensive test coverage
better-auth/better-auth3⭐ 19651When adding new functionality, configuration options, or plugins, always include corresponding tests that v...
-
API consistency standards
better-auth/better-auth3⭐ 19651Maintain consistent parameter formats and requirements across all API providers and endpoints. When documen...
-
Use standard API abstractions
bazelbuild/bazel3⭐ 24489Prefer established, type-safe abstractions over primitive types or direct property access when designing AP...
-
explicit null checks
bazelbuild/bazel3⭐ 24489Use explicit null/undefined checks instead of methods that silently handle missing values. When you expect ...
-
Environment-aware configuration testing
bazelbuild/bazel3⭐ 24489When writing tests for configuration-dependent functionality, implement environment detection and condition...
-
Clarify configuration examples
bazelbuild/bazel3⭐ 24489Configuration documentation should provide concrete, platform-specific examples rather than generic placeho...
-
Check operation failures
bazelbuild/bazel3⭐ 24489Always validate inputs and check return values of operations that can fail, providing clear error messages ...
-
Avoid eager cache invalidation
bazelbuild/bazel3⭐ 24489Resist the urge to eagerly invalidate cache entries unless you have definitive proof that the cached data i...
-
Surface errors appropriately
Azure/azure-sdk-for-net3⭐ 5809Ensure errors are visible and properly handled rather than silently processed or hidden. Provide mechanisms...
-
Prefer identity-based authentication
Azure/azure-sdk-for-net3⭐ 5809Always prioritize modern identity-based authentication methods over traditional username/password credentia...
-
Follow formatting standards
Azure/azure-sdk-for-net3⭐ 5809Maintain consistent code formatting by adhering to the defined standards in the .editorconfig file and Azur...
-
Descriptive consistent identifiers
Azure/azure-sdk-for-net3⭐ 5809Use clear, descriptive identifiers that accurately reflect their purpose, and maintain consistent naming pa...
-
Centralize pipeline configurations
Azure/azure-sdk-for-net3⭐ 5809Use centralized templates and variables for pipeline configurations instead of duplicating or hardcoding va...
-
Document feature flags
tokio-rs/axum3⭐ 22100When configuring feature flags in Cargo.toml, ensure they are properly structured and documented. Chain fea...
-
Proper Axios Configuration and Usage
axios/axios3⭐ 107000When implementing code that uses the Axios library in TypeScript, it is important to follow best practices ...
-
Consistent Naming Conventions for Axios Requests and Responses
axios/axios3⭐ 107000When using the Axios library in TypeScript, it is important to follow consistent naming conventions to impr...
-
Configuration property standards
axios/axios3⭐ 107000Always define configuration properties with sensible defaults and consistent naming conventions. When addin...
-
Validate configurations with clarity
aws/aws-sdk-js3⭐ 7628Configuration validation should use explicit checks and clear conditional logic to improve code readability...
-
Test configuration precedence
aws/aws-sdk-js3⭐ 7628When implementing systems that load configuration from multiple sources, always test the precedence rules e...
-
Limit cache size
aws/aws-sdk-js3⭐ 7628Always implement size constraints on caches to prevent memory leaks and performance degradation. Unbounded ...
-
Follow established testing patterns
aws/aws-sdk-js3⭐ 7628When writing tests, use existing patterns and infrastructure already established in the codebase rather tha...
-
Explicit verified configurations
aws/aws-sdk-js3⭐ 7628Always specify configuration values explicitly and verify their accuracy against official documentation or ...
-
Document APIs completely
aws/aws-sdk-js3⭐ 7628Always provide complete, clear, and contextually rich documentation for all public APIs. Documentation shou...
-
optimize CI efficiency
avelino/awesome-go3⭐ 151435Optimize CI/CD pipelines by minimizing resource usage and avoiding unnecessary operations. Use lightweight ...
-
Enforce coverage thresholds
avelino/awesome-go3⭐ 151435All code contributions must meet a minimum test coverage threshold of 80% before being accepted. This ensur...
-
Validate configuration appropriateness
argoproj/argo-cd3⭐ 20149Ensure configurations are contextually appropriate and properly validated for their intended use case. This...
-
Extract testable units
argoproj/argo-cd3⭐ 20149Avoid copying or reimplementing production logic in test files. Instead, refactor the production code to ex...
-
Comprehensive function documentation
argoproj/argo-cd3⭐ 20149Functions should have thorough documentation that follows Go conventions and explains both the "what" and "...
-
API documentation clarity
argoproj/argo-cd3⭐ 20149Ensure API parameter documentation clearly specifies default values, valid options, error conditions, and p...
-
Version migration dependencies carefully
appwrite/appwrite3⭐ 51959When updating dependencies for migration-related components or making schema changes, verify compatibility ...
-
Validate configuration formatting
appwrite/appwrite3⭐ 51959Ensure all JSON configuration files adhere to proper syntax and formatting conventions. Common issues to av...
-
Use object methods consistently
appwrite/appwrite3⭐ 51959When working with Document objects, always use their accessor methods rather than array-style syntax. Use `...
-
Self-contained test scenarios
appwrite/appwrite3⭐ 51959Tests should be fully self-contained to ensure reliability and prevent unexpected failures. Each test scena...
-
Resilient configuration patterns
appwrite/appwrite3⭐ 51959When modifying or defining configuration values, use patterns that are resistant to future changes and sile...
-
OpenAPI spec compliance
appwrite/appwrite3⭐ 51959Ensure all API definitions strictly follow OpenAPI specification standards to maintain compatibility with t...
-
Guard database query results
appwrite/appwrite3⭐ 51959Always validate database query results before accessing their methods or properties. Methods like `findOne(...
-
Active service health checks
appwrite/appwrite3⭐ 51959Replace static delays with active health checks in CI/CD workflows to ensure service readiness. Instead of ...
-
Standardize deprecation documentation
ant-design/ant-design3⭐ 95882When marking APIs, components, or features as deprecated, use consistent JSDoc @deprecated tags with clear ...
-
Optimize expensive operations
ant-design/ant-design3⭐ 95882Minimize performance impact of costly operations through strategic ordering, batching, and avoiding unneces...
-
Centralize configuration management
ant-design/ant-design3⭐ 95882Avoid duplicate configuration processing and keep configuration data properly centralized. When configurati...
-
Avoid unnecessary memoization
ant-design/ant-design3⭐ 95882Memoization (useMemo, useCallback, React.memo) should only be used when the performance benefits outweigh t...
-
Avoid hardcoded configuration values
ant-design/ant-design3⭐ 95882Replace hardcoded values in configuration code with design tokens, parameters, or configurable constants to...
-
Verify SSR documentation accuracy
angular/angular3⭐ 98611Ensure that documentation about server-side rendering (SSR), static site generation (SSG), and related rend...
-
precise build targeting
angular/angular3⭐ 98611Build targets should use specific file patterns rather than broad globs to improve build performance, clari...
-
limit error handling scope
angular/angular3⭐ 98611When implementing error handling, carefully limit the scope of try-catch blocks to prevent cascading failur...
-
Clarify configuration option limitations
angular/angular3⭐ 98611When documenting or designing configuration options, explicitly state both what the option does AND what it...
-
Build configuration consistency
angular/angular3⭐ 98611Maintain consistent build and release configurations across the project by following established patterns a...
-
API terminology consistency
angular/angular3⭐ 98611Maintain consistent, precise terminology throughout API documentation and interfaces. Avoid ambiguous or mi...
-
Use constraining types
alacritty/alacritty3⭐ 59675API functions should use specific types and enums to clearly communicate valid parameter values rather than...
-
Follow metadata specifications
alacritty/alacritty3⭐ 59675When writing metadata files (such as AppStream, package manifests, or configuration files), always consult ...
-
Consistent naming conventions
alacritty/alacritty3⭐ 59675Maintain consistent naming patterns and capitalization throughout the codebase, especially for configuratio...
-
Choose familiar, intuitive names
alacritty/alacritty3⭐ 59675When naming variables, methods, or configuration options, prioritize terms that are both intuitive to users...
-
Follow naming conventions
apache/airflow3⭐ 40858Use proper naming conventions to make code more readable and maintainable: 1. **Functions should start wit...
-
Enforce authentication boundaries
apache/airflow3⭐ 40858Implement strict authentication boundaries and access controls to prevent security vulnerabilities: 1. Whe...
-
Document intentional choices
apache/airflow3⭐ 40858Add explanatory comments for non-obvious code decisions that might appear incorrect, unusual, or suboptimal...
-
Standardize model access
Aider-AI/aider3⭐ 35856When integrating AI models into applications, provide consistent configuration methods that support differe...
-
Validate pattern matching
vercel/ai3⭐ 15590When implementing algorithms that involve pattern matching or data parsing, ensure robustness across all ed...
-
Test before documenting
vercel/ai3⭐ 15590Always thoroughly test API features and endpoints before documenting them, especially when integrating with...
-
Provide actionable examples
vercel/ai3⭐ 15590Documentation should include concrete, executable code examples rather than vague instructions. Make your e...
-
Document configuration decisions
vercel/ai3⭐ 15590When modifying configuration files (package.json, tsconfig.json, etc.), document the reasoning behind signi...
-
Async error callbacks
vercel/ai3⭐ 15590When handling asynchronous operations, especially those that might continue running in the background after...
-
Use descriptive names
cloudflare/agents3⭐ 2312Choose clear, descriptive names for variables, methods, types, and parameters that unambiguously convey the...
-
Use definite assignment assertions
cloudflare/agents3⭐ 2312When you're certain a value will be initialized but TypeScript can't infer this, use the definite assignmen...
-
Explicit API parameters
cloudflare/agents3⭐ 2312Design APIs with explicit parameters rather than implicit defaults or hidden behavior. When an API function...
-
Balance organization with constraints
cloudflare/agents3⭐ 2312When making code organization decisions, consider the broader impact beyond just eliminating duplication or...
-
Proper documentation linking
zed-industries/zed2⭐ 62119Documentation should use appropriate linking strategies to ensure content remains accessible and navigable ...
-
Precise test pattern matching
zed-industries/zed2⭐ 62119When identifying test patterns in code, use specific equality predicates (`#eq?`) instead of list inclusion...
-
Minimize credential exposure lifetime
zed-industries/zed2⭐ 62119Credentials and secrets should never be stored persistently in memory or written to files. Instead, use eph...
-
Explicit over implicit
zed-industries/zed2⭐ 62119When designing APIs, prioritize explicit parameter identification over implicit context. APIs with clear, u...
-
Document configuration clearly
zed-industries/zed2⭐ 62119When adding or modifying configuration parameters, especially in JSON settings files, ensure they are clear...
-
Write focused single-purpose tests
facebook/yoga2⭐ 18255Tests should focus on validating one specific behavior or scenario rather than combining multiple test case...
-
verify configuration completeness
facebook/yoga2⭐ 18255Always verify that configuration files completely and accurately specify their requirements. This includes ...
-
Use semantic naming
facebook/yoga2⭐ 18255Choose semantic, logical names that describe purpose and intent rather than physical characteristics or imp...
-
Use descriptive function names
facebook/yoga2⭐ 18255Function names should clearly convey their purpose and behavior, not just their signature or implementation...
-
Use appropriate CI toolchains
facebook/yoga2⭐ 18255Ensure CI/CD workflows use technology-specific setup actions and execute commands in the correct working di...
-
understand undefined value semantics
facebook/yoga2⭐ 18255Before modifying initialization patterns or removing static variables, investigate the semantic meaning of ...
-
separate formatting from logging
facebook/yoga2⭐ 18255Design logging utility functions to return formatted strings rather than directly performing logging operat...
-
Safe configuration definitions
facebook/yoga2⭐ 18255When defining configuration flags and options, use practices that ensure compatibility across different pre...
-
Reset algorithm state internally
facebook/yoga2⭐ 18255Algorithms should handle their own state initialization and cleanup internally rather than relying on calle...
-
prevent off-by-one errors
facebook/yoga2⭐ 18255When implementing algorithms that involve spacing, gaps, or iterative calculations, carefully verify loop b...
-
Pin dependency versions
facebook/yoga2⭐ 18255Always specify exact versions for dependencies and avoid pointing to moving targets like "master" branches ...
-
Manage resource lifecycles
facebook/yoga2⭐ 18255Ensure proper resource allocation and cleanup pairing, and maintain clear ownership semantics to prevent me...
-
Keep configuration versions current
facebook/yoga2⭐ 18255Regularly review and update version specifications in configuration files to align with current standards a...
-
Follow language naming conventions
facebook/yoga2⭐ 18255Ensure all identifiers (properties, methods, classes, variables) follow the established naming conventions ...
-
Extract complex conditions
facebook/yoga2⭐ 18255When encountering complex conditional expressions or generic variable references, extract them into clearly...
-
Enforce style in CI
facebook/yoga2⭐ 18255Configure automated formatting tools in CI/CD pipelines to enforce code style standards rather than silentl...
-
Control structure formatting
facebook/yoga2⭐ 18255Always use braces for control structures (if, for, while, etc.) even for single statements, and maintain co...
-
Choose meaningful identifiers
facebook/yoga2⭐ 18255All identifiers including parameters, files, functions, and categories should clearly communicate their pur...
-
Centralize configuration values
facebook/yoga2⭐ 18255Consolidate all configuration variables, constants, and settings into a centralized configuration object ra...
-
Cache expensive computations
facebook/yoga2⭐ 18255Identify and cache the results of expensive computations to avoid redundant calculations, especially in per...
-
benchmark performance optimizations
facebook/yoga2⭐ 18255Always measure and validate performance optimizations through benchmarking before assuming they provide ben...
-
Avoid configuration side effects
facebook/yoga2⭐ 18255Configuration properties should behave predictably without hidden side effects that override explicitly set...
-
avoid build side effects
facebook/yoga2⭐ 18255Build scripts should avoid performing operations as side effects and instead use explicit, dedicated tasks ...
-
preserve URL integrity
mountain-loop/yaak2⭐ 13008When manipulating URLs for API calls, prioritize preserving the original URL structure over using convenien...
-
workflow documentation clarity
cloudflare/workers-sdk2⭐ 3379Ensure all workflow-related documentation, help text, and code comments use proper grammar and punctuation....
-
Use configuration placeholders
cloudflare/workers-sdk2⭐ 3379Configuration files should use placeholder values like `
` instead of hardcoded values for fields that ... -
telemetry documentation consistency
cloudflare/workers-sdk2⭐ 3379Maintain consistent formatting and style when documenting telemetry and observability systems. This include...
-
Respect automated tooling
cloudflare/workers-sdk2⭐ 3379Avoid manually updating files or configurations that are managed by automated CI/CD tools. Many modern deve...
-
Provide specific examples
cloudflare/workers-sdk2⭐ 3379Documentation should include concrete, actionable examples and use clear, unambiguous terminology to elimin...
-
maintain clean project structure
cloudflare/workers-sdk2⭐ 3379Keep your codebase organized and clutter-free by removing unnecessary files, directories, and artifacts tha...
-
Explicit configuration definitions
cloudflare/workers-sdk2⭐ 3379Ensure all configuration dependencies and environment variables are explicitly defined rather than relying ...
-
document workflow capabilities
cloudflare/workers-sdk2⭐ 3379Workflow methods should include comments that document their orchestration capabilities and data access pat...
-
Design repeatable CI workflows
cloudflare/workers-sdk2⭐ 3379CI workflows should be idempotent and handle cleanup automatically to avoid manual intervention and ensure ...
-
Design intuitive API interfaces
cloudflare/workers-sdk2⭐ 3379APIs should be designed with user experience in mind, accepting inputs in formats users naturally encounter...
-
validate post-manipulation state
cloudflare/workerd2⭐ 6989Always explicitly validate object state after performing manipulations that could potentially result in nul...
-
Use appropriate API methods
cloudflare/workerd2⭐ 6989When integrating with external APIs or implementing interface methods, ensure you're using the correct API ...
-
Test comprehensive error scenarios
cloudflare/workerd2⭐ 6989When implementing error handling, ensure comprehensive test coverage by testing multiple error scenarios, e...
-
optimize CI resource usage
cloudflare/workerd2⭐ 6989Design CI workflows to maximize resource efficiency by reusing build artifacts across jobs whenever possibl...
-
Optimize algorithm performance
cloudflare/workerd2⭐ 6989When implementing algorithms, prioritize performance by using batching techniques to reduce API call overhe...
-
Format observability test data
cloudflare/workerd2⭐ 6989When writing tests for observability systems (tracing, metrics, logging), structure test assertions to be e...
-
extract repeated expressions
cloudflare/workerd2⭐ 6989When the same expression or computation appears multiple times within a code block, extract it to a variabl...
-
ensure test cleanup
cloudflare/workerd2⭐ 6989Tests must properly clean up resources and handle conditional execution regardless of test outcome. This in...
-
Choose appropriate logging functions
cloudflare/workerd2⭐ 6989Select the correct logging function based on frequency, severity, and destination to avoid log spam and ens...
-
Balance configuration automation complexity
cloudflare/workerd2⭐ 6989When implementing configuration management solutions, carefully weigh the benefits of automation against th...
-
avoid unnecessary Arc wrapping
cloudflare/workerd2⭐ 6989Don't wrap atomic types in Arc unless you need to share ownership across multiple owners. Atomic types like...
-
Descriptive semantic naming
microsoft/vscode2⭐ 174887Names should accurately reflect their purpose and behavior, providing users and developers with clear expec...
-
Configuration naming conventions
microsoft/vscode2⭐ 174887When adding new configuration settings, follow these naming conventions to maintain consistency and clarity...
-
Use latest patch versions
volcano-sh/volcano2⭐ 4899When configuring dependencies in Dockerfiles and other configuration files, use the latest patch versions w...
-
Use controlled concurrency patterns
volcano-sh/volcano2⭐ 4899Implement proper concurrency control mechanisms to prevent resource exhaustion and ensure thread-safe opera...
-
Review security permissions
volcano-sh/volcano2⭐ 4899Carefully review all security permissions and privileges to ensure they follow the principle of least privi...
-
Resource-specific optimization factors
volcano-sh/volcano2⭐ 4899Configure different optimization parameters for different resource types (CPU, memory, GPU) rather than app...
-
Protocol-specific network discovery
volcano-sh/volcano2⭐ 4899When implementing network topology discovery features, use discovery methods that are appropriate for the s...
-
network topology plugin configuration
volcano-sh/volcano2⭐ 4899When implementing network topology-aware scheduling, ensure that the appropriate topology plugins are prope...
-
Implement simulation testing
volcano-sh/volcano2⭐ 4899When developing complex systems like schedulers or resource managers, create simulation-based testing frame...
-
Avoid external configuration dependencies
volcano-sh/volcano2⭐ 4899When designing configuration management systems, avoid strong dependencies on external projects for configu...
-
API validation consistency
volcano-sh/volcano2⭐ 4899Ensure API validation rules and type definitions remain consistent across all validation layers and compone...
-
Optimize tensor memory operations
vllm-project/vllm2⭐ 51730When working with PyTorch tensors, use memory-efficient operations that avoid unnecessary copies. Specify m...
-
Optimize GPU execution
vllm-project/vllm2⭐ 51730Ensure GPU code is optimized for both proper thread utilization and correct architecture dispatching: 1. *...
-
Match reference names
vllm-project/vllm2⭐ 51730Ensure that filenames and paths referenced in scripts, commands, or configuration files exactly match the a...
-
Environment-aware configuration values
vllm-project/vllm2⭐ 51730When creating configuration files or defining configuration constants, ensure they properly adapt to differ...
-
Combine identical CSS
vllm-project/vllm2⭐ 51730When multiple CSS selectors share identical styling properties, combine them using comma separation rather ...
-
AI model persistence
vllm-project/vllm2⭐ 51730When containerizing AI applications, ensure proper model persistence by mounting volumes to the default cac...
-
Validate environment configurations
vitessio/vitess2⭐ 19815Ensure that all environment-specific configurations work properly across all target environments, particula...
-
Size fields appropriately
vitessio/vitess2⭐ 19815When designing database schemas, choose field types and sizes that accommodate both current and anticipated...
-
Pin environment versions
vitessio/vitess2⭐ 19815Always use explicit version tags for CI/CD environments (runners, containers, images, tool versions) instea...
-
Manage workflow state transitions
vitessio/vitess2⭐ 19815When working with temporal workflows, always implement explicit state transitions rather than abrupt deleti...
-
Justify CI resource additions
vitessio/vitess2⭐ 19815Before adding new resources (Dockerfiles, jobs, images) to CI/CD pipelines, provide clear justification for...
-
Document configuration precedence
vitessio/vitess2⭐ 19815When implementing multiple configuration methods (e.g., config files, command-line flags, environment varia...
-
Database configuration best practices
vitessio/vitess2⭐ 19815When implementing or modifying database-related configurations, follow these principles: 1. Use semantical...
-
Consistent database APIs
vitessio/vitess2⭐ 19815Design database APIs with consistent patterns for response structures and error handling. Follow establishe...
-
Clear metric documentation
vitessio/vitess2⭐ 19815When adding, modifying, or deprecating metrics, ensure comprehensive and clear documentation. Include: 1. ...
-
Avoid skipping e2e tests
vitessio/vitess2⭐ 19815Do not use the `skip_e2e` flag to bypass end-to-end tests that fail. Instead, fix the test implementation b...
-
Vue component import handling
vitejs/vite2⭐ 74031When working with Vue single-file components, pay special attention to how imports are processed, particula...
-
Targeted yet comprehensive
vitejs/vite2⭐ 74031Write focused tests that verify specific functionality without unnecessary setup, while still ensuring comp...
-
Separate configuration responsibilities
vitejs/vite2⭐ 74031Design configuration files with clear separation of responsibilities and maintain flexibility for future ch...
-
Self-referential worker URLs
vitejs/vite2⭐ 74031When creating Web Workers for network communication, use self-referential URL patterns that are resilient t...
-
React transformation tool clarity
vitejs/vite2⭐ 74031When working with React in Vite projects, be precise about which transformation tools (Babel, SWC, Oxc, esb...
-
Precise documentation language
vitejs/vite2⭐ 74031Use specific and clear language in all documentation to improve user understanding and avoid ambiguity. Fav...
-
Explicit version requirements
vitejs/vite2⭐ 74031Always specify explicit Node.js version requirements in configuration files to ensure compatibility with la...
-
Document protocol configurations clearly
vitejs/vite2⭐ 74031When documenting network protocol configurations (TLS, HTTP/2, CORS), provide specific details about requir...
-
Configure SSR environments
vitejs/vite2⭐ 74031When implementing server-side rendering in Next.js projects that use Vite as a bundler, ensure proper envir...
-
Complete deployment commands
vitejs/vite2⭐ 74031Always ensure build commands in CI/CD configurations include all necessary steps for successful deployment,...
-
Code example consistency
vitejs/vite2⭐ 74031Ensure code examples in documentation and comments are syntactically correct and properly marked with the a...
-
Clean network resources
vitejs/vite2⭐ 74031Always properly close and clean up network connections to prevent memory leaks and resource exhaustion. Whe...
-
use `-prod` for performance
vlang/v2⭐ 36582Always use the `-prod` compiler flag when building performance-critical code or running benchmarks. The `-p...
-
Test deployment edge cases
astral-sh/uv2⭐ 60322Ensure that code paths handling different deployment environments (installation prefixes, target directorie...
-
Optimize docker build caching
astral-sh/uv2⭐ 60322Leverage Docker BuildKit's cache and bind mount capabilities to dramatically improve CI build times and red...
-
Document build configurations
astral-sh/uv2⭐ 60322When setting Rust build configurations, especially in CI/Docker environments, explicitly document optimizat...
-
Cache sharing strategy
astral-sh/uv2⭐ 60322When implementing caching in build systems, carefully configure cache sharing behavior based on your concur...
-
Avoid unnecessary constraints
astral-sh/uv2⭐ 60322When specifying dependencies and version requirements in project configuration files, avoid adding unnecess...
-
Validate API parameter formats
Unstructured-IO/unstructured2⭐ 12117Ensure API parameters match the expected format and structure of target APIs before runtime. Validate param...
-
Use descriptive specific names
Unstructured-IO/unstructured2⭐ 12117Choose names that clearly indicate their context and purpose rather than generic terms. Generic names can b...
-
separate formatting changes
Unstructured-IO/unstructured2⭐ 12117Keep formatting and style changes separate from functional code changes to maintain clear, reviewable diffs...
-
Python version standardization
Unstructured-IO/unstructured2⭐ 12117Establish and document a consistent Python version standard for dependency compilation across the project. ...
-
Parameterize hardcoded configuration values
Unstructured-IO/unstructured2⭐ 12117Replace hardcoded values in configuration files with parameterized variables to improve flexibility and mai...
-
maintain established naming conventions
Unstructured-IO/unstructured2⭐ 12117Ensure all naming follows established patterns and conventions already present in the codebase. When introd...
-
intentional naming patterns
Unstructured-IO/unstructured2⭐ 12117Recognize when seemingly redundant naming patterns serve specific technical purposes rather than being mist...
-
improve code readability
Unstructured-IO/unstructured2⭐ 12117Format code to enhance readability and maintainability by breaking long lines and extracting repeated value...
-
Enhance documentation detail
Unstructured-IO/unstructured2⭐ 12117Documentation should provide comprehensive detail that enables users to understand impacts and developers t...
-
embedding provider configuration
Unstructured-IO/unstructured2⭐ 12117When configuring embedding providers in AI integrations, ensure proper dimension specification and use dedi...
-
Document configuration parameters clearly
Unstructured-IO/unstructured2⭐ 12117When documenting configuration objects and their parameters, provide clear explanations of each parameter's...
-
Centralize configuration sources
Unstructured-IO/unstructured2⭐ 12117Maintain configuration settings in a single authoritative source to avoid duplication and inconsistencies a...
-
avoid hardcoded secrets
Unstructured-IO/unstructured2⭐ 12117Never include real API keys, passwords, or other sensitive credentials directly in source code, including e...
-
Version serializable structures
unionlabs/union2⭐ 74800All serializable data structures that may evolve over time must include explicit versioning to enable backw...
-
Validate network addresses
unionlabs/union2⭐ 74800Always validate network addresses according to their specific protocol requirements and maintain consistent...
-
validate input uniqueness
unionlabs/union2⭐ 74800Always validate that input data is unique and matches expected values to prevent replay attacks and data ma...
-
preserve original error codes
unionlabs/union2⭐ 74800When handling errors, preserve the original error information rather than replacing it with generic error c...
-
organize for readability
unionlabs/union2⭐ 74800Structure code to minimize repetition and improve clarity through appropriate abstraction and import organi...
-
Optimize database queries
unionlabs/union2⭐ 74800When writing database queries, prioritize both performance and correctness. Avoid unnecessary joins that ca...
-
Mock external dependencies
unionlabs/union2⭐ 74800Always mock external dependencies in tests to ensure isolation and reliability. Unit tests should not make ...
-
Environment-specific configuration values
unionlabs/union2⭐ 74800Avoid hardcoding configuration values that should vary between different deployment environments (testnet, ...
-
Environment-aware logging configuration
unionlabs/union2⭐ 74800Configure logging behavior dynamically based on the current environment to ensure appropriate log levels an...
-
Ensure semantic precision
unionlabs/union2⭐ 74800Choose names and identifiers that precisely convey their intended semantic meaning and avoid ambiguity or c...
-
Ensure comprehensive test coverage
unionlabs/union2⭐ 74800All new functionality must include corresponding tests that verify both success and failure scenarios. When...
-
Clean documentation links
unionlabs/union2⭐ 74800When writing Rust documentation links, separate the display name from the full path to improve readability ...
-
avoid unnecessary memory operations
unionlabs/union2⭐ 74800Be mindful of memory usage when working with large data structures. Avoid unnecessary clones of large objec...
-
avoid suppressing TypeScript errors
unionlabs/union2⭐ 74800Do not use `@ts-expect-error` comments to suppress TypeScript errors, especially those related to null, und...
-
Use concise methods
shadcn-ui/ui2⭐ 90568Prefer built-in methods and properties that achieve the same result with less code. This improves readabili...
-
Use cross-platform build commands
bytedance/UI-TARS-desktop2⭐ 18021Replace native shell commands in package.json scripts with cross-platform alternatives to ensure build cons...
-
Native fetch over dependencies
bytedance/UI-TARS-desktop2⭐ 18021Prefer Node.js native fetch API over external HTTP client libraries like `node-fetch` when the target Node....
-
Externalize configuration values
bytedance/UI-TARS-desktop2⭐ 18021Avoid hard-coding configuration values directly in source files. Instead, externalize them using environmen...
-
Preprocess data early
shadcn-ui/ui2⭐ 90568Transform and prepare data structures at their source rather than during consumption. This includes flatten...
-
Optimize documentation for usability
shadcn-ui/ui2⭐ 90568When creating component documentation, prioritize the developer experience by providing clear, usable examp...
-
Consistent import paths
shadcn-ui/ui2⭐ 90568Establish and follow consistent import path conventions throughout the codebase. Prefer aliased imports usi...
-
Use TypeScript-specific tests
microsoft/typescript2⭐ 105378Always use fourslash tests (for IDE/language service features) or compiler tests (for TypeScript compilatio...
-
Use absolute paths
microsoft/typescript2⭐ 105378When specifying file paths in configuration files (like ESLint or TypeScript configs), use absolute paths r...
-
Streamline workflow configurations
microsoft/typescript2⭐ 105378Maintain efficient and properly structured CI/CD workflows by removing unnecessary dependencies and using c...
-
Consistent module resolution
microsoft/typescript2⭐ 105378Configure consistent module resolution strategies across related projects and ensure package.json files are...
-
Consistent message terminology
microsoft/typescript2⭐ 105378Use clear, consistent terminology in all error messages and user-facing text. Avoid technical jargon that m...
-
Actionable error messages
microsoft/typescript2⭐ 105378When designing APIs, provide error messages that are contextually accurate, descriptive, and actionable. Ge...
-
Single source of truth
twentyhq/twenty2⭐ 35477Establish a single authoritative source for each piece of data in your API interfaces rather than maintaini...
-
optimize data structure lookups
twentyhq/twenty2⭐ 35477Choose data structures that provide optimal time complexity for your access patterns. When you need frequen...
-
Follow React component patterns
twentyhq/twenty2⭐ 35477React components should be rendered as standard JSX elements, not called as functions, and should follow es...
-
Enforce restrictive security defaults
twentyhq/twenty2⭐ 35477Always start with the most restrictive security settings and only grant additional permissions when absolut...
-
Verify test commands
vercel/turborepo2⭐ 28115Always verify that test commands documented in project guides work exactly as written. Test commands should...
-
Use workspace dependencies consistently
vercel/turborepo2⭐ 28115Always use workspace-level dependency declarations (`workspace = true`) rather than specifying exact versio...
-
Use JSDoc deprecation standards
vercel/turborepo2⭐ 28115When marking code as deprecated, use JSDoc standards to provide clear guidance for developers. Always use t...
-
Use environment-aware configurations
vercel/turborepo2⭐ 28115Configure paths and system references dynamically to ensure they work across all environments (development,...
-
Link terms, provide examples
vercel/turborepo2⭐ 28115When writing technical documentation, link to related concepts the first time they are mentioned, and inclu...
-
Hybrid monorepo testing
vercel/turborepo2⭐ 28115When working with tests in a monorepo, implement a hybrid testing approach that balances local development ...
-
Handle errors appropriately
vercel/turborepo2⭐ 28115Implement appropriate error handling strategies based on the criticality of operations. For non-critical op...
-
Graceful error recovery
vercel/turborepo2⭐ 28115Implement error handling that accumulates diagnostics rather than failing immediately, especially for opera...
-
Framework-specific entrypoints organization
vercel/turborepo2⭐ 28115When creating libraries that integrate with Next.js or other frameworks, organize your code with separate e...
-
Design for testability
vercel/turborepo2⭐ 28115Extract complex logic into separate, pure functions to improve testability. Functions with clear inputs and...
-
Consider config generation methods
vercel/turborepo2⭐ 28115When implementing code to handle configuration files like lockfiles or environment settings, carefully cons...
-
validate inputs early
tree-sitter/tree-sitter2⭐ 21799Functions should validate input parameters at the beginning and return appropriate error indicators (like f...
-
validate algorithmic inputs
tree-sitter/tree-sitter2⭐ 21799Always validate inputs and handle edge cases before performing algorithmic operations, especially when deal...
-
target-specific CMake configurations
tree-sitter/tree-sitter2⭐ 21799Use target-specific CMake commands instead of global ones to ensure proper scoping and avoid polluting the ...
-
Strategic configuration exclusions
tree-sitter/tree-sitter2⭐ 21799When configuring build exclusions in package manifests or configuration files, be strategic and minimal. On...
-
optimize memory usage patterns
tree-sitter/tree-sitter2⭐ 21799Focus on reducing memory footprint and improving cache efficiency through careful data structure design and...
-
measure performance implications
tree-sitter/tree-sitter2⭐ 21799When making design decisions that could impact performance, evaluate resource implications and provide conc...
-
Ensure semantic naming clarity
tree-sitter/tree-sitter2⭐ 21799Names should clearly convey their semantic purpose and avoid conflicts that reduce code readability. This a...
-
Document configuration changes
tree-sitter/tree-sitter2⭐ 21799When modifying configuration files (tsconfig.json, environment configs, build settings, etc.), always provi...
-
descriptive naming patterns
tree-sitter/tree-sitter2⭐ 21799Use descriptive names that clearly indicate the expected format, convention, or constraints. This applies t...
-
Cross-platform configuration examples
tree-sitter/tree-sitter2⭐ 21799Ensure configuration examples and documentation work across different operating systems and clearly disting...
-
Complete technical documentation
tree-sitter/tree-sitter2⭐ 21799When documenting technical features, APIs, or data structures, provide comprehensive coverage that includes...
-
CMake custom command design
tree-sitter/tree-sitter2⭐ 21799When implementing CMake build automation for code generation, carefully choose between `add_custom_command`...
-
Clarify API documentation
tree-sitter/tree-sitter2⭐ 21799API documentation should provide clear, unambiguous explanations of function behavior, return values, and e...
-
automate frequent releases
tree-sitter/tree-sitter2⭐ 21799Implement automated release workflows to publish updates frequently and consistently across all distributio...
-
Assert null before access
tree-sitter/tree-sitter2⭐ 21799When asserting conditions on potentially null pointers, always check for null first before accessing the po...
-
API type definition consistency
tree-sitter/tree-sitter2⭐ 21799When modifying API type definitions, ensure all related definition files are updated consistently and depen...
-
API documentation synchronization
tree-sitter/tree-sitter2⭐ 21799Ensure that all API documentation, including code examples and integration guides, accurately reflects the ...
-
provide contextual error information
traefik/traefik2⭐ 55772Ensure error messages and logging provide sufficient context to understand what failed and why. Include rel...
-
proper context handling
traefik/traefik2⭐ 55772Always propagate contexts consistently throughout the call chain and handle context cancellation properly i...
-
optimize selection algorithms
traefik/traefik2⭐ 55772When implementing selection algorithms that choose from a pool of candidates, design the algorithm to filte...
-
Health check lifecycle completeness
traefik/traefik2⭐ 55772Ensure health check systems are not only created but also properly launched and integrated with observabili...
-
avoid external dependencies
traefik/traefik2⭐ 55772Unit tests should not depend on external components like databases, Redis, or Kubernetes clusters. Instead,...
-
Follow established naming conventions
bytedance/trae-agent2⭐ 9088Adhere to established naming conventions consistently throughout the codebase, prioritizing official docume...
-
Externalize hardcoded configurations
bytedance/trae-agent2⭐ 9088Configuration values should be externalized to environment variables rather than hardcoded in the source co...
-
Test production configurations too
tokio-rs/tokio2⭐ 28981Include testing configurations that mirror production environments to catch issues that might only manifest...
-
Test diverse configurations
tokio-rs/tokio2⭐ 28989Configure test suites to run under multiple specialized environments to catch issues that might not appear ...
-
Simplify configuration flags
tokio-rs/tokio2⭐ 28989Keep configuration flags, feature toggles, and build settings concise and well-organized. Use simpler names...
-
Version AI dependencies appropriately
huggingface/tokenizers2⭐ 9868When adding or updating dependencies for AI/ML libraries in your project, follow these two key practices: ...
-
Use explicit assertions
huggingface/tokenizers2⭐ 9868Tests should assert specific expected values rather than just verifying general functionality. This practic...
-
Test algorithmic behavior
huggingface/tokenizers2⭐ 9868When testing algorithms, verify their actual functionality rather than just checking for proper instantiati...
-
Smart configuration defaults
huggingface/tokenizers2⭐ 9868Prefer smart configuration defaults that auto-detect the environment instead of requiring explicit configur...
-
Robust workflow configurations
huggingface/tokenizers2⭐ 9868Ensure CI/CD workflow configuration files follow best practices for maintainability and correctness: 1. Us...
-
Prioritize tokenizer simplicity
huggingface/tokenizers2⭐ 9868When implementing AI model components like tokenizers, favor simplicity over rarely-used features that sign...
-
Flexible tokenizer implementation
huggingface/tokenizers2⭐ 9868When implementing tokenizers for AI models, ensure flexibility and robust behavior across different context...
-
Document for comprehension
huggingface/tokenizers2⭐ 9868Add comprehensive documentation that helps others understand both the interface and implementation of your ...
-
Consistent API design
huggingface/tokenizers2⭐ 9868When designing and modifying APIs, ensure consistency in parameter naming, default values, and which functi...
-
Secure checkout configurations
hashicorp/terraform2⭐ 45532When configuring GitHub Actions workflows, pay special attention to the checkout action's configuration to ...
-
Explicit dependency graph
hashicorp/terraform2⭐ 45532When implementing algorithms involving dependencies between components or operations, model the dependency ...
-
Descriptive migration functions
hashicorp/terraform2⭐ 45532Name migration-related functions descriptively to convey their exact purpose and context of use. Include de...
-
Specify security requirements
microsoft/terminal2⭐ 99242Always explicitly declare security requirements and provide clear security guidance in both configuration f...
-
Protocol response formatting
microsoft/terminal2⭐ 99242When implementing terminal protocol responses (CSI, DCS, OSC sequences), ensure proper formatting with corr...
-
API clarity over convenience
microsoft/terminal2⭐ 99242When designing APIs, prioritize clarity and self-documentation over implementation convenience. Choose inte...
-
Add comprehensive explanatory comments
microsoft/terminal2⭐ 99242When code involves complex relationships between multiple components or non-obvious usage patterns, add com...
-
Verify platform compatibility first
tensorflow/tensorflow2⭐ 190625When writing networking code that interacts with platform-specific features, always check for the existence...
-
Use modern assertions
tensorflow/tensorflow2⭐ 190625Always use current assertion methods in test code to ensure clarity and future compatibility. Specifically,...
-
Secure infrastructure maintenance
tensorflow/tensorflow2⭐ 190625Maintain CI/CD infrastructure with security and currency as top priorities. This includes: 1. **Keep build...
-
Parameterize ci/cd scripts
tensorflow/tensorflow2⭐ 190625Avoid duplicating CI/CD scripts by leveraging configuration files and parameterization instead of creating ...
-
Framework migration instructions
tensorflow/tensorflow2⭐ 190625When documenting AI framework migrations (like TensorFlow/Keras version changes), provide complete instruct...
-
Format lines and comments
tensorflow/tensorflow2⭐ 190625Ensure all code follows formatting guidelines for readability and consistency. Keep lines under 80 characte...
-
Document non-obvious code
tensorflow/tensorflow2⭐ 190625Add clarifying comments to improve code readability and maintainability when code behavior isn't immediatel...
-
Consistent variable naming
tensorflow/tensorflow2⭐ 190625Use ALL_CAPS for constants and environment variables in shell scripts, and reference these variables consis...
-
Build dependency synchronization
tensorflow/tensorflow2⭐ 190625When adding new imports to code files, always synchronize by updating the corresponding dependencies in BUI...
-
Be explicit in references
tensorflow/tensorflow2⭐ 190625When writing documentation, always be specific and explicit when referring to files, tools, configurations,...
-
Protocol buffer organization
temporalio/temporal2⭐ 14953When defining protocol buffer messages, prioritize good organization and reuse: 1. Reuse existing message ...
-
Protobuf extensibility patterns
temporalio/temporal2⭐ 14953When designing Protocol Buffer APIs, use `oneof` fields to create extensible message structures that mainta...
-
Optimize API consumption
temporalio/temporal2⭐ 14953When interacting with APIs, minimize network requests and improve code maintainability by: 1. Extracting re...
-
Explicit CI configuration conditions
temporalio/temporal2⭐ 14953When writing CI/CD workflow configurations, always use explicit and precise conditions, paths, and selector...
-
Configure OpenTelemetry programmatically
temporalio/temporal2⭐ 14953Configure OpenTelemetry programmatically rather than through environment variables or command-line flags. T...
-
Analyze algorithm tradeoffs
temporalio/temporal2⭐ 14953When implementing functionality that involves multiple possible algorithmic approaches, explicitly analyze ...
-
validate before access
gravitational/teleport2⭐ 19109Always check for null, empty, or unset values before accessing or processing them, and return meaningful er...
-
Use semantic HTML elements
gravitational/teleport2⭐ 19109When creating interactive components in React, use proper HTML semantic elements as the foundation, even wh...
-
Safe null handling
gravitational/teleport2⭐ 19109Always handle potentially null or undefined values defensively using appropriate JavaScript patterns. Choos...
-
parameterize configuration values
gravitational/teleport2⭐ 19109Avoid hardcoded values in configuration files and templates. Make settings parameterizable with sensible de...
-
Network address clarity
gravitational/teleport2⭐ 19109When documenting or configuring network addresses, DNS names, and IP addresses, be explicit about traffic d...
-
Follow platform naming conventions
gravitational/teleport2⭐ 19109Always use the correct naming conventions for the platform you're working with, particularly React and HTML...
-
Environment variable precedence
gravitational/teleport2⭐ 19109When working with environment variables in configuration management, ensure proper precedence handling and ...
-
Environment-specific configuration identifiers
gravitational/teleport2⭐ 19109Use distinct, environment-specific identifiers in configuration to prevent conflicts between different appl...
-
Design intuitive query interfaces
gravitational/teleport2⭐ 19109When designing algorithms for querying, filtering, or data manipulation, prioritize user-friendly function ...
-
Design comprehensive metrics
gravitational/teleport2⭐ 19109When designing observability metrics, ensure they are explicit about all possible states, comprehensive in ...
-
defensive error handling
gravitational/teleport2⭐ 19109Implement defensive programming practices to prevent runtime errors and provide meaningful error informatio...
-
Database query parameter hygiene
gravitational/teleport2⭐ 19109Ensure all database query parameters serve a clear purpose and are properly utilized. Remove unused filter ...
-
avoid platform-specific CI features
gravitational/teleport2⭐ 19109Avoid using CI platform-specific features in workflows to prevent vendor lock-in and ensure portability. In...
-
Assess optimization necessity
gravitational/teleport2⭐ 19109Evaluate whether performance optimizations are actually needed based on your specific context, data size, a...
-
Swift style consistency
tensorflow/swift2⭐ 6136Maintain consistent Swift style conventions throughout all code, including examples in documentation and co...
-
Minimize cross-device transfers
tensorflow/swift2⭐ 6136Data transfers between different compute devices (CPU/host to GPU/accelerator and back) can significantly i...
-
Follow Swift conventions
tensorflow/swift2⭐ 6136When designing and documenting APIs in Swift, adhere to Swift's established naming conventions and document...
-
Handle AI provider inconsistencies
SWE-agent/SWE-agent2⭐ 16839When integrating with AI model providers, implement defensive programming to handle API inconsistencies, bu...
-
Document configuration decisions
SWE-agent/SWE-agent2⭐ 16839When making configuration changes, especially those involving version specifications or constraints, includ...
-
Document configuration clarity
SWE-agent/SWE-agent2⭐ 16839Ensure all configuration options and setup instructions are clearly documented with their intended purposes...
-
Write clear test cases
sveltejs/svelte2⭐ 83580Tests should be written with clear intent and expectations. Use descriptive names that accurately reflect w...
-
Validate configuration interdependencies
sveltejs/svelte2⭐ 83580When configuration options have logical dependencies or constraints, implement both smart defaults and vali...
-
SSR documentation clarity
sveltejs/svelte2⭐ 83580Ensure server-side rendering documentation is grammatically correct and clearly explains the differences be...
-
Runtime HTML escaping
sveltejs/svelte2⭐ 83580HTML escaping must occur at runtime, not during compilation or build time, to properly prevent XSS vulnerab...
-
optimize computational complexity
sveltejs/svelte2⭐ 83580When implementing algorithms, especially in runtime or performance-critical code, prioritize computational ...
-
Justify configuration changes
sveltejs/svelte2⭐ 83580When making configuration changes, especially dependency upgrades, provide clear justification for why the ...
-
Format complex CSS selectors
sveltejs/svelte2⭐ 83580When working with complex CSS selectors that include multiple nested pseudo-selectors like `:is()`, `:where...
-
Follow snake_case convention
sveltejs/svelte2⭐ 83580Consistently use snake_case naming throughout the codebase for variables, methods, and identifiers to maint...
-
Document non-obvious behavior
sveltejs/svelte2⭐ 83580Write documentation that explains behavior and context that may not be obvious to newcomers, even if it see...
-
avoid unclear abbreviations
sveltejs/svelte2⭐ 83580Use clear, descriptive names instead of abbreviated variable names that reduce code readability. Abbreviati...
-
Use null strategically
supabase/supabase2⭐ 86070When handling empty or missing values, be intentional about using `null`, `undefined`, or empty strings bas...
-
Use appropriate HTTP methods
supabase/supabase2⭐ 86070Choose HTTP methods that align with the actual operation being performed. Use GET for retrieving data with ...
-
Sync environment variables
supabase/supabase2⭐ 86070When converting hardcoded values to environment variables in configuration files (like docker-compose.yml),...
-
Safe database operations
supabase/supabase2⭐ 86070When modifying database structures or executing dynamic SQL queries, prioritize both performance and safety...
-
Optimize large field queries
supabase/supabase2⭐ 86070When working with database queries that process large text fields or arrays, choose operations that minimiz...
-
Consistent case style
supabase/supabase2⭐ 86070Use consistent case styles in your codebase, adapting to the conventions of the ecosystem you're interactin...
-
Connection resilience patterns
supabase/supabase2⭐ 86070Implement resilient networking connections with retry mechanisms for all client-service interactions. When ...
-
Concise performance documentation
supabase/supabase2⭐ 86070When documenting performance metrics, benchmarks, or scalability information, prioritize clarity and concis...
-
Avoid code duplication
supabase/supabase2⭐ 86070Maintain clean, maintainable code by avoiding duplication and following proper code organization principles...
-
Keep build scripts portable
browserbase/stagehand2⭐ 16443Build scripts should remain environment-agnostic and free from personal customizations or assumptions about...
-
Control caching through instantiation
browserbase/stagehand2⭐ 16443When implementing optional caching functionality, control cache behavior through conditional instantiation ...
-
AI provider naming standards
browserbase/stagehand2⭐ 16443Maintain consistent and proper naming conventions for AI model providers throughout code, documentation, an...
-
AI dependency classification
browserbase/stagehand2⭐ 16443When adding AI/ML libraries to a project, carefully consider whether they belong in `dependencies` or `devD...
-
Verify operation semantics
spring-projects/spring-framework2⭐ 58382When implementing algorithms that process collections or use conditional logic, always verify the exact sem...
-
Use documentation features properly
spring-projects/spring-framework2⭐ 58382Utilize Asciidoc features correctly when writing or updating Spring Framework documentation. Instead of har...
-
Structured log message quality
spring-projects/spring-boot2⭐ 77637Design log messages to be clear, concise, and properly structured to maximize their utility for debugging a...
-
Stable observability components
spring-projects/spring-boot2⭐ 77637Always use stable, production-ready versions of observability components (libraries, dependencies, and docu...
-
Include database-specific migration dependencies
spring-projects/spring-boot2⭐ 77637When implementing database migrations with tools like Flyway, ensure you include the appropriate database-s...
-
Environment variables best practices
spring-projects/spring-boot2⭐ 77637When working with environment variables in configuration files, follow these practices to ensure reliabilit...
-
Consistent terminology usage
spring-projects/spring-boot2⭐ 77637When referring to technical concepts in documentation and code comments, use proper full names and consiste...
-
Clear structured logging documentation
spring-projects/spring-boot2⭐ 77637Document structured logging implementations with clarity, explicitly noting precedence rules and interactio...
-
Bean lifecycle management
spring-projects/spring-boot2⭐ 77637When using containers and external services in Spring applications (especially with Testcontainers), declar...
-
validate before data access
apache/spark2⭐ 41554Always validate for null or None values before accessing data elements, especially when working with collec...
-
Test algorithmic performance scaling
apache/spark2⭐ 41554When implementing or modifying algorithms, especially data structures like hash tables, bloom filters, or p...
-
prefer system properties directly
apache/spark2⭐ 41554When detecting operating system or environment characteristics, prefer direct access to system properties o...
-
optimize expensive operations
apache/spark2⭐ 41554Before executing computationally expensive operations, implement conditional checks to determine if the ope...
-
ensure test isolation
apache/spark2⭐ 41554Tests must properly clean up resources and avoid side effects that can impact other tests, especially when ...
-
Eliminate unnecessary complexity
apache/spark2⭐ 41554Remove unnecessary default parameters and consolidate related conditional logic to improve code clarity and...
-
consistent null handling
apache/spark2⭐ 41554Maintain consistency in null handling patterns across the codebase. When multiple approaches exist for repr...
-
Complete method documentation
apache/spark2⭐ 41554All public methods, especially in interfaces and APIs, must have comprehensive JavaDoc documentation that c...
-
Numeric API completeness
bytedance/sonic2⭐ 8532When designing APIs that handle numeric values, ensure comprehensive support for different integer types (I...
-
Meaningful comment practices
bytedance/sonic2⭐ 8532Comments should explain the reasoning behind code decisions rather than restating what the code obviously d...
-
Maintain consistent formatting
bytedance/sonic2⭐ 8532Ensure all code follows the established project formatting standards consistently across the codebase. This...
-
Function documentation standards
bytedance/sonic2⭐ 8532Function documentation comments must follow Go conventions by starting with the function name, and all para...
-
Empty vs nil distinction
bytedance/sonic2⭐ 8532Always distinguish between nil and empty values when handling nullable types, as they carry different seman...
-
Defensive error handling
bytedance/sonic2⭐ 8532Implement defensive checks when managing error state to prevent overwriting existing errors and add safegua...
-
consistent code formatting
bytedance/sonic2⭐ 8532Maintain consistent indentation and brace alignment throughout the codebase to improve readability and code...
-
bounds checking first
bytedance/sonic2⭐ 8532Always validate array and buffer bounds before accessing elements to prevent out-of-bounds access and poten...
-
validate before accessing
SigNoz/signoz2⭐ 23369Always validate bounds, nil pointers, and other potentially unsafe conditions before accessing values to pr...
-
Use descriptive names
SigNoz/signoz2⭐ 23369Variable and function names should clearly communicate their actual purpose and behavior, not just their in...
-
reuse existing utilities
SigNoz/signoz2⭐ 23369Before creating new utility functions, check if existing ones can be reused or extended. Avoid code duplica...
-
provide defaults when destructuring
SigNoz/signoz2⭐ 23369When destructuring properties from objects that might contain undefined values, use the nullish coalescing ...
-
Prefer realistic testing
SigNoz/signoz2⭐ 23369Write tests that closely mirror real user interactions and application behavior rather than relying on arti...
-
orchestrate observability services
SigNoz/signoz2⭐ 23369When setting up observability infrastructure in build systems, use proper dependency management and descrip...
-
Optimize React architecture
SigNoz/signoz2⭐ 23369Prefer direct hook usage over prop drilling and carefully consider context provider placement to maintain c...
-
Observability correctness and maintainability
SigNoz/signoz2⭐ 23369Ensure observability implementations prioritize both mathematical correctness and code maintainability. Obs...
-
meaningful ABC usage
SigNoz/signoz2⭐ 23369Only inherit from ABC when you have abstract methods that subclasses must implement. Avoid using ABC inheri...
-
justify caching strategies
SigNoz/signoz2⭐ 23369When implementing caching solutions, clearly document and justify your caching strategy decisions based on ...
-
Explicit configuration management
SigNoz/signoz2⭐ 23369Configuration changes should be intentional, well-documented, and implemented using clean, understandable p...
-
Ensure log message clarity
SigNoz/signoz2⭐ 23369Log messages should be clear, unambiguous, and avoid creating confusion for developers and operators. This ...
-
Configuration migration fallbacks
SigNoz/signoz2⭐ 23369When configuration structures evolve, implement fallback mechanisms to handle both old and new formats grac...
-
avoid inline object creation
SigNoz/signoz2⭐ 23369Inline objects and functions created within render methods are recreated on every render, causing unnecessa...
-
Add tests for new code
SigNoz/signoz2⭐ 23369All new code additions, regardless of complexity, should include corresponding unit tests to ensure functio...
-
CUDA compatibility verification
sgl-project/sglang2⭐ 17245When modifying CUDA versions or GPU architecture configurations in AI/ML projects, verify compatibility acr...
-
consolidate duplicated logic
sgl-project/sglang2⭐ 17245When you identify duplicated code patterns across different branches or functions, consolidate the shared l...
-
Avoid broad exception catching
sgl-project/sglang2⭐ 17245Avoid using overly broad exception handling like `except Exception` as it can mask specific errors and make...
-
AI model documentation consistency
sgl-project/sglang2⭐ 17245Ensure consistent parameter names and configuration instructions across AI model documentation. Inconsisten...
-
AI dependency justification
sgl-project/sglang2⭐ 17245When modifying AI library dependencies, always provide clear justification for version choices, especially ...
-
validate subprocess errors comprehensively
servo/servo2⭐ 32962When executing external commands via subprocess, don't rely solely on return codes for error detection. Som...
-
Network request configuration
servo/servo2⭐ 32962When creating network requests, ensure all security-sensitive parameters are properly configured including ...
-
implement security validation
servo/servo2⭐ 32962Ensure all security-related functionality includes complete validation checks and proper testing. This appl...
-
enhance testing interfaces
servo/servo2⭐ 32962Design testing tool interfaces to be both flexible and discoverable. Support multiple keyword variations fo...
-
configuration parameter handling
servo/servo2⭐ 32962When working with configuration parameters and values, follow these best practices to ensure maintainable a...
-
Algorithm edge case validation
servo/servo2⭐ 32962Ensure algorithmic implementations properly handle edge cases and boundary conditions before considering th...
-
maintain proper formatting
serverless/serverless2⭐ 46810Ensure code and configuration files follow proper formatting standards that maintain both syntactic validit...
-
maintain naming consistency
serverless/serverless2⭐ 46810Ensure consistent naming patterns across related components and configurations. When naming properties, met...
-
maintain configuration standards
serverless/serverless2⭐ 46810Ensure configuration files maintain both consistency and currency across all services. Configuration values...
-
explicit observability configuration
serverless/serverless2⭐ 46810Ensure observability features are configured explicitly with clear documentation about their scope and impa...
-
Complete CI/CD documentation
serverless/serverless2⭐ 46810Ensure all CI/CD documentation is comprehensive and technically accurate, covering complete workflows and t...
-
prefer marketplace actions
oraios/serena2⭐ 14465Before implementing custom tool installation steps in GitHub Actions workflows, check if there's an existin...
-
Inline configuration dictionaries
oraios/serena2⭐ 14465Avoid storing simple configuration data in separate JSON files. Instead, define configuration as Python dic...
-
Use acks_late for reliability
getsentry/sentry2⭐ 41297Configure Celery tasks with `acks_late=True` when task reliability is critical and you prefer to risk dupli...
-
Reduce code nesting
getsentry/sentry2⭐ 41297Excessive indentation makes code harder to read and understand. Two common techniques can help flatten your...
-
Keep testing dependencies current
getsentry/sentry-php2⭐ 1873Regularly update testing framework dependencies (PHPUnit, PHPStan, etc.) to maintain compatibility with you...
-
Ensure test isolation
getsentry/sentry-php2⭐ 1873Tests should be independent and isolated from each other to prevent state leakage and ensure reliable resul...
-
Dynamic error configuration
getsentry/sentry-php2⭐ 1873Design error handling systems that respect runtime changes to error settings rather than fixing configurati...
-
Document configuration comprehensively
getsentry/sentry-php2⭐ 1873When adding or modifying configuration options, ensure they are documented with complete context. Group rel...
-
Optimize lookup operations
getsentry/sentry2⭐ 41297Choose appropriate data structures to minimize computational complexity when performing lookups. Prefer dir...
-
Migration model imports
getsentry/sentry2⭐ 41297When writing Django migrations, avoid importing and referencing external models directly. Django migrations...
-
Meaningful test design
getsentry/sentry2⭐ 41297Write tests that focus on unique edge cases and avoid redundancy. When designing test suites: 1. Consolida...
-
Validate CI pipeline inputs
semgrep/semgrep2⭐ 12598Always validate and sanitize dynamic inputs in CI/CD pipelines before using them in URLs, file operations, ...
-
Use proper URI parsing
semgrep/semgrep2⭐ 12598When working with URLs and URIs in networking code, use proper URI parsing libraries and types instead of s...
-
use consistent JavaScript syntax
semgrep/semgrep2⭐ 12598Maintain consistent use of modern JavaScript syntax throughout networking code to improve reliability and m...
-
use appropriate test markers
semgrep/semgrep2⭐ 12598Test markers and annotations should match the test type and context they're applied to. Different test cate...
-
justify error handling design
semgrep/semgrep2⭐ 12598When implementing error handling mechanisms, ensure that design decisions are well-justified and properly r...
-
CI blocking with overrides
strands-agents/sdk-python2⭐ 4044When implementing CI checks that can block pull request merges, always provide clear override mechanisms fo...
-
Balance configuration practicality
strands-agents/sdk-python2⭐ 4044When making configuration changes, balance technical best practices with developer workflow requirements an...
-
AI dependency management
strands-agents/sdk-python2⭐ 4044When integrating AI libraries and SDKs, carefully manage dependencies by pinning versions with upper bounds...
-
Synchronize configuration files
rust-lang/rust2⭐ 105254Ensure all related configuration files are updated consistently when making changes to dependencies, versio...
-
Optimize dependency configurations
rust-lang/rust2⭐ 105254When configuring project dependencies, be mindful of feature flags that may introduce unnecessary build dep...
-
Normalize variable test output
rust-lang/rust2⭐ 105254When writing tests that capture output (like UI tests, stderr, or stdout), ensure you normalize any variabl...
-
Conditional CI resource management
rust-lang/rust2⭐ 105254Configure CI workflows to intelligently manage system resources through conditional execution rather than d...
-
Use utility macros
dotnet/runtime2⭐ 16578Use predefined utility macros for common operations instead of repeating manual calculations throughout you...
-
Platform-aware algorithm optimization
dotnet/runtime2⭐ 16578When implementing performance-critical algorithms, design your code to detect and utilize platform-specific...
-
Optimize aligned SIMD operations
dotnet/runtime2⭐ 16578Always use proper memory alignment for SIMD (Single Instruction, Multiple Data) operations to maximize perf...
-
Names reflect actual purpose
dotnet/runtime2⭐ 16578Name variables, properties, and functions to accurately reflect their purpose and actual usage in code, not...
-
Memory barrier pairing
dotnet/runtime2⭐ 16578When implementing low-level synchronization mechanisms in multi-threaded code, ensure that memory barriers ...
-
Maintain configuration compatibility
dotnet/runtime2⭐ 16578When modifying configuration systems, prioritize backward compatibility unless there's an explicit breaking...
-
Honor API contracts
dotnet/runtime2⭐ 16578When implementing or modifying APIs, carefully preserve the historical behavior and semantic contracts of e...
-
Feature flag implementation
dotnet/runtime2⭐ 16578When implementing feature flags, ensure consistency between runtime and compiled scenarios. Feature switche...
-
Explicit API versioning
dotnet/runtime2⭐ 16578When extending interfaces with new methods or functionality, always implement proper versioning to ensure c...
-
Enable configurable instrumentation
dotnet/runtime2⭐ 16578Always provide configurable options for performance instrumentation and hardware acceleration in your codeb...
-
Document non-obvious logic
dotnet/runtime2⭐ 16578Add clear comments explaining the purpose and reasoning behind complex or non-obvious code logic. Comments ...
-
Document function contracts
dotnet/runtime2⭐ 16578Always document function contracts completely, even when surrounding code lacks documentation. Include head...
-
Centralize platform configurations
dotnet/runtime2⭐ 16578Platform-specific code and API usage should be centralized in designated configuration files rather than sc...
-
Test edge cases
astral-sh/ruff2⭐ 40619When writing tests, prioritize coverage of edge cases and non-standard code patterns to ensure robust funct...
-
Single yield algorithm
astral-sh/ruff2⭐ 40619Context managers must follow a crucial algorithmic constraint: each execution path must yield exactly once....
-
Logical content organization
astral-sh/ruff2⭐ 40619Organize code and documentation logically based on functionality and dependencies. Place files in directori...
-
Clear and relevant comments
astral-sh/ruff2⭐ 40619Ensure all comments in the codebase provide value and clarity rather than creating confusion. Remove commen...
-
Prioritize code legibility
TanStack/router2⭐ 11590Write clear, explicit code that prioritizes readability over brevity. Remove unnecessary operations and use...
-
Optimize React patterns
TanStack/router2⭐ 11590Prefer derived values over state and use appropriate React hooks for better performance and cleaner code. W...
-
optimize file-based routing
TanStack/router2⭐ 11590Implement lazy loading patterns and strategic code-splitting in file-based routing systems to improve perfo...
-
memoize for render optimization
TanStack/router2⭐ 11590Use React memoization techniques strategically to prevent unnecessary re-renders and recomputations when va...
-
Intentional async usage
TanStack/router2⭐ 11590Be deliberate about when to use the `async` keyword and `await` expressions. Making a function `async` chan...
-
defensive null checking
TanStack/router2⭐ 11590Always perform explicit null and undefined checks before accessing object properties or methods to prevent ...
-
comprehensive test validation
TanStack/router2⭐ 11590Tests should validate all relevant aspects of the system to ensure comprehensive coverage. This includes in...
-
Clear contextual error messages
TanStack/router2⭐ 11590Error messages should be specific, contextually relevant, and provide actionable guidance to developers. Av...
-
break complex expressions
TanStack/router2⭐ 11590Break down complex boolean expressions and conditions into well-named intermediate variables to improve cod...
-
avoid unnecessary workflow restrictions
TanStack/router2⭐ 11590Remove unnecessary approval gates, custom tokens, and restrictive conditions in CI/CD workflows when existi...
-
Avoid repeated object creation
TanStack/router2⭐ 11590Prevent performance degradation by avoiding the creation of functions, objects, regular expressions, and ot...
-
Verify documentation references
RooCodeInc/Roo-Code2⭐ 17288Ensure all references in documentation (file paths, commands, code examples) actually exist in the codebase...
-
Sanitize user inputs
RooCodeInc/Roo-Code2⭐ 17288Always validate and sanitize user-provided inputs before using them in security-sensitive operations to pre...
-
Avoid hardcoded configurations
RooCodeInc/Roo-Code2⭐ 17288Always extract configuration values from appropriate sources (config files, environment variables, etc.) ra...
-
Separate multiple imports
smallcloudai/refact2⭐ 3114When importing multiple items from the same module, use separate import statements instead of combining the...
-
prefer simpler implementations
smallcloudai/refact2⭐ 3114When writing code, favor simpler, more straightforward implementations over complex ones. Look for opportun...
-
optimize timing intervals
smallcloudai/refact2⭐ 3114Choose appropriate timing intervals for asynchronous operations to improve performance and responsiveness. ...
-
Follow API design conventions
smallcloudai/refact2⭐ 3114Ensure API endpoints adhere to established design conventions including proper HTTP methods, authorization ...
-
Ensure semantic naming clarity
smallcloudai/refact2⭐ 3114Names should clearly communicate their actual behavior and preserve sufficient context for meaningful ident...
-
Complete model configurations
smallcloudai/refact2⭐ 3114When adding new models to configuration files, ensure all required configuration fields are populated, not ...
-
avoid problematic identifier names
smallcloudai/refact2⭐ 3114Choose identifier names that avoid system compatibility issues and follow proper naming conventions. Avoid ...
-
Write readable conditionals
facebook/react2⭐ 237000Structure conditionals for maximum clarity and comprehension. Avoid unnecessary negation in boolean express...
-
Standardize URL handling
facebook/react2⭐ 237000When working with URLs in networking code, always use the standard `URL` constructor to properly resolve re...
-
Structure documentation interfaces
remix-run/react-router2⭐ 55270Organize interfaces and component props documentation to improve API clarity and maintainability. Extract r...
-
Remove obsolete configuration options
remix-run/react-router2⭐ 55270Proactively remove configuration options that are no longer functional or relevant to prevent developer con...
-
Pin problematic dependencies
remix-run/react-router2⭐ 55270When external dependencies or tools in CI/CD pipelines have known regressions or bugs, pin them to stable v...
-
organize test scripts properly
remix-run/react-router2⭐ 55270Keep base test scripts generic and create specialized variants for specific workflows. Base scripts like "t...
-
Implement recursive safeguards
remix-run/react-router2⭐ 55270When implementing recursive algorithms, always include cycle detection and early termination conditions to ...
-
Handle SSR hydration mismatches
remix-run/react-router2⭐ 55270When implementing server-side rendering, proactively handle scenarios where server and client rendering may...
-
distinguish falsy vs nullish
remix-run/react-router2⭐ 55270When handling potentially null or undefined values, carefully choose between the logical OR (`||`) and null...
-
Configure React build environments
remix-run/react-router2⭐ 55270Ensure proper environment and module configuration for React applications to load the correct versions and ...
-
configure build tools properly
remix-run/react-router2⭐ 55270Ensure build configurations use proper package.json exports fields and TypeScript settings to avoid hard-co...
-
Complete accurate documentation
remix-run/react-router2⭐ 55270Documentation should provide complete, accurate guidance that doesn't mislead developers about correct usag...
-
avoid timing-dependent tests
remix-run/react-router2⭐ 55270Tests should not rely on fixed delays, arbitrary timeouts, or assume deterministic ordering of asynchronous...
-
Proper Usage of React Hooks
facebook/react2⭐ 237000When using the React library in TypeScript, ensure that you are correctly implementing the recommended Reac...
-
Proper Scoping and Usage of React Variables
facebook/react2⭐ 237000When implementing React components, it is important to ensure that variables are properly scoped and used t...
-
Validate configuration formats
facebook/react-native2⭐ 123178Ensure configuration values use the correct data format expected by target systems and avoid duplication by...
-
Use proper documentation format
facebook/react-native2⭐ 123178Use the appropriate documentation format for the target programming language. In Kotlin files, use KDoc for...
-
Use Kotlin testing idioms
facebook/react-native2⭐ 123178When writing tests in Kotlin, prefer Kotlin-specific testing libraries and language features over their Jav...
-
Use appropriate log levels
facebook/react-native2⭐ 123178Choose logging levels that match the intended audience and purpose of the message. Use debug or silent logg...
-
Replace magic numbers
facebook/react-native2⭐ 123178Replace magic numbers with named constants to improve code readability and maintainability. Magic numbers m...
-
prefer explicit code
facebook/react-native2⭐ 123178Write code that explicitly states its intent rather than relying on implicit behavior or complex constructs...
-
platform-aware configuration messages
facebook/react-native2⭐ 123178Configuration-related error messages, troubleshooting guidance, and feature flags should be accurate and ac...
-
platform API consistency
facebook/react-native2⭐ 123178When implementing cross-platform functionality, prioritize consistency and avoid replicating platform-speci...
-
Optimize CI platform builds
facebook/react-native2⭐ 123178When configuring CI/CD build pipelines, limit builds to only the platforms your project actively supports a...
-
Optimize algorithmic choices
facebook/react-native2⭐ 123178When implementing algorithms, prioritize both correctness and efficiency by selecting the most appropriate ...
-
manage component state dependencies
facebook/react-native2⭐ 123178Ensure React components have all necessary state information before rendering and that lifecycle events don...
-
maintain cross-platform API consistency
facebook/react-native2⭐ 123178When designing APIs that work across multiple platforms, ensure consistent return types and behavior to avo...
-
maintain API backwards compatibility
facebook/react-native2⭐ 123178When modifying existing public APIs, prioritize backwards compatibility to avoid breaking external consumer...
-
Follow existing naming conventions
facebook/react-native2⭐ 123178When adding new variables, methods, or constants, always follow the naming conventions already established ...
-
Follow established naming conventions
facebook/react-native2⭐ 123178Ensure all identifiers (variables, methods, classes) adhere to the project's established naming conventions...
-
Environment variable validation
facebook/react-native2⭐ 123178Environment variables should be properly validated with correct type checking and without redundant conditi...
-
configuration consistency management
facebook/react-native2⭐ 123178Maintain consistent configuration references across all code branches and document temporary configuration ...
-
Component initialization state
facebook/react-native2⭐ 123178Ensure components properly handle initialization state during their lifecycle, particularly when being recy...
-
avoid unnecessary component complexity
facebook/react-native2⭐ 123178When designing React components and their APIs, resist the temptation to add features, props, or methods th...
-
avoid unnecessary allocations
facebook/react-native2⭐ 123178When implementing algorithms and data structure operations, avoid unnecessary memory allocations, object cr...
-
Multi-stack config settings
facebook/react2⭐ 237000When creating configuration files for development environments that use multiple technology stacks, ensure ...
-
Explicit CSP nonce management
facebook/react2⭐ 237000When implementing Content Security Policy (CSP) protections, always explicitly pass nonce values to compone...
-
Dry configuration patterns
facebook/react2⭐ 237000Apply DRY (Don't Repeat Yourself) principles to all configuration files to improve maintainability. Extract...
-
Document code intent
facebook/react2⭐ 237000Add clear comments that explain the intent and behavior of code that might not be immediately obvious to ot...
-
Defensive Handling of Nullable React Components
facebook/react2⭐ 237000When working with React components that may return null or undefined values, implement defensive coding pat...
-
Test helpers for maintainability
rails/rails2⭐ 57027Create reusable helper methods for common testing operations to improve test maintainability and consistenc...
-
AI library version compatibility
QwenLM/Qwen32⭐ 24226When documenting AI/ML model deployment and inference procedures, always test and specify compatible librar...
-
Spring DI precedence rules
quarkusio/quarkus2⭐ 14667When developing Quarkus extensions that interact with classes containing Spring annotations (like `@Service...
-
Prevent metrics cardinality explosion
quarkusio/quarkus2⭐ 14667When implementing metrics and telemetry in your application, avoid using dynamic values like path parameter...
-
Optimize elimination paths
quarkusio/quarkus2⭐ 14667When implementing algorithms that process large data structures or complex computational paths, prioritize ...
-
Keep configurations current
quarkusio/quarkus2⭐ 14667Always use the latest stable and supported versions in configuration files. This applies to runtime environ...
-
Document observability context flows
quarkusio/quarkus2⭐ 14667When implementing observability features like OpenTelemetry exporters, metrics collection, or distributed t...
-
Design fluent HTTP APIs
quarkusio/quarkus2⭐ 14667When designing HTTP-related APIs, prioritize readability and intuitiveness through well-crafted fluent inte...
-
Consolidate duplicate configurations
quarkusio/quarkus2⭐ 14667Maintain a single source of truth for configuration files instead of duplicating them across the codebase. ...
-
Type-appropriate null representation
pytorch/pytorch2⭐ 91345Always use type-appropriate mechanisms to represent the absence of a value. For objects, use default constr...
-
Reuse existing algorithms
pytorch/pytorch2⭐ 91345Before implementing common algorithms or utilities, check if the codebase already contains an appropriate i...
-
Preserve API compatibility
pytorch/pytorch2⭐ 91345When modifying existing APIs, always prioritize backward compatibility to avoid breaking client code. Befor...
-
Optimize container operations
pytorch/pytorch2⭐ 91345Minimize CPU overhead in container operations by using efficient data structure patterns: 1. **Use static ...
-
Hardware acceleration considerations
pytorch/pytorch2⭐ 91345When implementing hardware-accelerated operations for AI models, ensure support for the latest architecture...
-
Descriptive unambiguous names
pytorch/pytorch2⭐ 91345Always use descriptive variable names that clearly indicate their purpose without requiring readers to chec...
-
Choose data structures wisely
pytorch/pytorch2⭐ 91345When designing algorithms, select data structures that accommodate all possible scenarios, not just the com...
-
Choose appropriate pointer types
pytorch/pytorch2⭐ 91345Select the right pointer type based on ownership semantics to prevent null reference issues and memory leak...
-
Centralize configuration detection
pytorch/pytorch2⭐ 91345Always use centralized configuration detection mechanisms (like CMake finder modules) instead of hardcoding...
-
Actionable error messages
pytorch/pytorch2⭐ 91345When writing error messages in PyTorch code, include not only what went wrong but also clear guidance on ho...
-
Specific types for performance
pydantic/pydantic2⭐ 24377Using concrete types instead of abstract container classes in data models improves validation performance. ...
-
Enforce style with linters
pydantic/pydantic2⭐ 24377Use automated linting tools to enforce consistent code style across the project, but be deliberate about wh...
-
Data structure correctness
pydantic/pydantic2⭐ 24377Ensure data structures are accurately represented with their proper constraints and valid implementations, ...
-
Avoid unnecessary operations
pydantic/pydantic2⭐ 24364Check conditions early to skip unnecessary processing and reuse computed values where possible to optimize ...
-
Write objectively
prowler-cloud/prowler2⭐ 11834Use an impersonal, objective tone in technical documentation. Avoid using second-person pronouns ("you") an...
-
Task signature methods
prowler-cloud/prowler2⭐ 11834When chaining Celery tasks, choose the correct signature method: - Use `.s()` when a task needs the output ...
-
Prefer server components
prowler-cloud/prowler2⭐ 11834Default to server components in Next.js applications to maximize the benefits of server-side rendering. Avo...
-
Parameterize configuration values
prowler-cloud/prowler2⭐ 11834Always extract configuration values (like versions, paths, or other changeable settings) into parameters ra...
-
Log exceptions with context
prowler-cloud/prowler2⭐ 11834When handling exceptions in your code, ensure they are properly logged with sufficient context to aid debug...
-
Format AI code identifiers
prowler-cloud/prowler2⭐ 11834When documenting AI systems, always format code identifiers, function names, agent names, model names, and ...
-
Flexible AI model versions
prowler-cloud/prowler2⭐ 11834When integrating LLM or AI models into your application, implement model selection in a way that accommodat...
-
Environment variables for configurations
prowler-cloud/prowler2⭐ 11834Store all configurable values such as URLs, API endpoints, and external service locations in environment va...
-
Endpoints for evolving data
prowler-cloud/prowler2⭐ 11834Design dedicated API endpoints for data that changes frequently or grows over time, rather than hardcoding ...
-
Enable database resilience
prowler-cloud/prowler2⭐ 11834Always configure appropriate resilience features for database services to ensure data durability and high a...
-
Consistent environment variable naming
prowler-cloud/prowler2⭐ 11834When naming environment variables, ensure that names are both technically accurate and follow established p...
-
Configure observability variables
prowler-cloud/prowler2⭐ 11834Always define all necessary environment variables for observability tools in configuration files, even if u...
-
Use proper configuration tooling
prometheus/prometheus2⭐ 59616When working with configuration files and values, prefer dedicated tools and canonical sources over manual ...
-
test practical monitoring scenarios
prometheus/prometheus2⭐ 59616When writing tests for observability features like metrics, functions, and alerting expressions, ensure tes...
-
Make build steps visible
prometheus/prometheus2⭐ 59616Build processes should provide clear, visible feedback about the operations being performed rather than sup...
-
leverage standard algorithms
prometheus/prometheus2⭐ 59616When implementing common algorithmic tasks like string parsing, sorting, or comparison operations, prefer b...
-
consistent parameter naming
prometheus/prometheus2⭐ 59616Maintain consistent naming and symbol choices throughout code and documentation, prioritizing readability a...
-
Validate sensitive operations
prisma/prisma2⭐ 42967Always implement safety checks before performing operations that could expose sensitive data or cause destr...
-
Research configuration format support
prisma/prisma2⭐ 42967When migrating configuration files to newer formats, research current ecosystem support before defaulting t...
-
Prioritize searchable names
prisma/prisma2⭐ 42967Choose names that are easily searchable and immediately understandable, avoiding unclear abbreviations and ...
-
Official product naming
prisma/prisma2⭐ 42967When referencing external products, libraries, or services in documentation and code, always use their offi...
-
Document network configuration
prisma/prisma2⭐ 42967When configuring network settings in containerized services, always document the reasoning behind specific ...
-
Document configuration alternatives
prisma/prisma2⭐ 42967When documenting configuration setup, provide multiple formats and approaches to accommodate different tool...
-
Design runtime-specific API exports
prisma/prisma2⭐ 42967When designing APIs that need to work across different JavaScript runtimes (Node.js, edge environments, bro...
-
Accurate method descriptions
prisma/prisma2⭐ 42967API documentation must precisely describe method behavior, especially return values and cardinality. Inaccu...
-
Vue syntax parsing robustness
prettier/prettier2⭐ 50772When processing Vue components, ensure parsing logic handles edge cases correctly and selects appropriate p...
-
Use example configuration files
prettier/prettier2⭐ 50772When providing team configuration files that developers might want to customize, use `.example` suffixes an...
-
Use descriptive names
prettier/prettier2⭐ 50772Choose names that clearly communicate purpose and meaning rather than implementation details or obscure abb...
-
Use cross-platform commands
prettier/prettier2⭐ 50772When writing CI/CD scripts and documentation, prefer Node.js APIs over shell commands for file operations t...
-
Test all variations
prettier/prettier2⭐ 50772Ensure comprehensive test coverage by testing all behavioral variations, configuration options, and edge ca...
-
targeted CSS modifications
prettier/prettier2⭐ 50772Make targeted, purposeful CSS modifications that either enhance visual presentation or fix specific functio...
-
Document CI workflow rationale
prettier/prettier2⭐ 50772Always include clear comments explaining the reasoning behind CI workflow decisions, including test environ...
-
cache invalidation strategy
prettier/prettier2⭐ 50772Implement comprehensive cache invalidation mechanisms that automatically handle format changes between vers...
-
Benchmark performance optimizations
prettier/prettier2⭐ 50772Always measure and validate performance optimizations with concrete benchmarks before implementing them. Pe...
-
Angular syntax parsing
prettier/prettier2⭐ 50772When implementing Angular syntax parsing, ensure robust handling of Angular-specific constructs by properly...
-
Verify error handling paths
PostHog/posthog2⭐ 28460When implementing error handling logic, ensure that both the behavior and reasoning are clear, and that err...
-
validate schema decisions
PostHog/posthog2⭐ 28460When reviewing database schema changes or data structure modifications, ensure that field inclusion/exclusi...
-
validate before use
PostHog/posthog2⭐ 28460Always validate that values are truthy or defined before using them, even when they are expected to exist. ...
-
Use error chain iterators
PostHog/posthog2⭐ 28460When traversing error chains in Rust, prefer using the `chain()` iterator method over manual source travers...
-
two-phase filtering algorithms
PostHog/posthog2⭐ 28460When working with large datasets or complex matching operations, implement algorithms that use a two-phase ...
-
Test edge cases comprehensively
PostHog/posthog2⭐ 28460Ensure your tests cover not just the happy path, but also edge cases, empty states, error conditions, and b...
-
Optimize database query patterns
PostHog/posthog2⭐ 28460Avoid N+1 query problems and overly complex conditional SQL construction. When loading related data, prefer...
-
minimize expensive operations
PostHog/posthog2⭐ 28460Avoid triggering expensive operations (queries, API calls, computations) on every user input or state chang...
-
Local configuration exclusion
PostHog/posthog2⭐ 28460Exclude personal and local configuration files from version control while ensuring they are properly handle...
-
leverage framework capabilities
PostHog/posthog2⭐ 28460Structure workflows and activities to take full advantage of the orchestration framework's built-in capabil...
-
Keep state in Kea
PostHog/posthog2⭐ 28460React components should focus on presentation and user interaction, not state management logic. All state l...
-
Follow CSS naming patterns
PostHog/posthog2⭐ 28460Maintain consistency with established CSS naming conventions already used in the codebase. For CSS classes,...
-
Environment-based configuration management
PostHog/posthog2⭐ 28460Prefer environment variables over file mounting for configuration values, and avoid hardcoded environment-s...
-
Enrich telemetry context
PostHog/posthog2⭐ 28460Always include relevant contextual metadata when capturing telemetry data (events, exceptions, logs, metric...
-
Configuration naming clarity
PostHog/posthog2⭐ 28460Ensure configuration variable names, display labels, and feature flag names accurately reflect their actual...
-
API parameter semantics
PostHog/posthog2⭐ 28460Ensure API parameters have clear semantic meaning and avoid sending null values for optional fields. When d...
-
API initialization side effects
PostHog/posthog2⭐ 28460When initializing API clients, prefer bootstrap/configuration patterns over method calls that may trigger u...
-
Add monitoring metrics
PostHog/posthog2⭐ 28460Critical code paths, especially error handling and exception scenarios, should include metrics or counters ...
-
Use consistent temporal types
pola-rs/polars2⭐ 34296When implementing or modifying temporal operations, maintain consistent data types that align with existing...
-
Edge case algorithm handling
pola-rs/polars2⭐ 34296When implementing algorithms, pay special attention to edge cases, particularly empty collections. Define a...
-
Cross-platform feature flags
pola-rs/polars2⭐ 34296When documenting package installation commands with feature flags, ensure compatibility across different op...
-
Verify configuration options
python-poetry/poetry2⭐ 33496Always verify that configuration file options and command flags are correct and properly documented. Incorr...
-
specify tool version requirements
python-poetry/poetry2⭐ 33496When documenting CI/CD tools and integrations, always specify exact version requirements and compatibility ...
-
Pin tool versions explicitly
python-poetry/poetry2⭐ 33496Always specify exact versions for tools and dependencies in CI/CD workflows to ensure reproducible builds a...
-
Network request configuration
python-poetry/poetry2⭐ 33496When implementing or documenting network functionality, ensure proper configuration options are provided an...
-
consistent semantic naming
python-poetry/poetry2⭐ 33496Names should follow established team conventions while accurately reflecting their purpose and functionalit...
-
Add missing code documentation
python-poetry/poetry2⭐ 33496Ensure all methods have docstrings and complex logic includes explanatory comments to help contributors und...
-
validate input rigorously
microsoft/playwright2⭐ 76113Always validate and sanitize input data against established standards to prevent injection attacks and ensu...
-
Use semantically clear names
microsoft/playwright2⭐ 76113Names should clearly communicate their actual purpose and be consistent across similar contexts. Avoid name...
-
Secure authentication state files
microsoft/playwright2⭐ 76113Authentication state files (such as browser session files, cookies, or tokens) contain sensitive credential...
-
Python syntax consistency
microsoft/playwright2⭐ 76113Ensure Python code follows proper naming conventions and syntax rules. Use snake_case for variable and para...
-
Justify dependency changes
microsoft/playwright2⭐ 76113Always provide clear justification when modifying dependency configurations, including version updates, dep...
-
Handle errors explicitly
microsoft/playwright2⭐ 76113Always provide explicit error handling instead of allowing silent failures or blank screens. Any place wher...
-
graceful process termination
microsoft/playwright2⭐ 76113Implement systematic cleanup mechanisms that handle process termination signals without generating excessiv...
-
Document network limitations
microsoft/playwright2⭐ 76113When documenting network-related features, clearly specify compatibility constraints, browser limitations, ...
-
Document configuration formats explicitly
microsoft/playwright2⭐ 76113When documenting environment variables and configuration options, explicitly list all supported value forma...
-
Document build configuration changes
microsoft/playwright2⭐ 76113When modifying build tool configurations, especially during migrations, provide detailed technical justific...
-
Comprehensive contextual error handling
microsoft/playwright2⭐ 76113Implement thorough error handling that goes beyond basic logging and provides contextually accurate, action...
-
API documentation precision
microsoft/playwright2⭐ 76113API documentation must use specific, well-defined types instead of generic ones, and clearly define behavio...
-
API consistency and decoupling
microsoft/playwright2⭐ 76113APIs should maintain consistent behavior and avoid tight coupling to implementation details or environmenta...
-
organize import groups
emcie-co/parlant2⭐ 12205Imports should be organized into distinct groups with proper spacing for better readability. Group all thir...
-
Make test descriptions specific
emcie-co/parlant2⭐ 12205Test scenarios and steps should use specific, descriptive language that clearly communicates what is being ...
-
Implement graceful error handling
emcie-co/parlant2⭐ 12205Replace assertions, unhandled exceptions, and error-suppression mechanisms with proper error handling that ...
-
Document meaningful complexity
emcie-co/parlant2⭐ 12205Documentation should add genuine value by explaining non-obvious behavior, complex approaches, or important...
-
Configuration design clarity
emcie-co/parlant2⭐ 12205Design configuration with clear semantics and appropriate scope. Avoid global constants for values that can...
-
Use relative documentation links
opentofu/opentofu2⭐ 25901When documenting error handling mechanisms, always use relative path references (`../path/to/file.mdx`) ins...
-
Review consistency assumptions
opentofu/opentofu2⭐ 25901Periodically reassess your database operations based on updated consistency guarantees offered by storage t...
-
Provider instance management
opentofu/opentofu2⭐ 25901Ensure proper configuration of provider instances when using environment-specific settings. When using `for...
-
Protect infrastructure secrets
opentofu/opentofu2⭐ 25901Infrastructure-as-code tools like OpenTofu may store sensitive information in plaintext state files, creati...
-
Document phased migration paths
opentofu/opentofu2⭐ 25901When replacing an existing system feature with a new implementation, provide a clear and well-documented ph...
-
Contextualize security findings
opentofu/opentofu2⭐ 25901When reporting security vulnerabilities, include sufficient context beyond just vulnerability IDs or codes....
-
Clear relationship descriptions
opentofu/opentofu2⭐ 25901When documenting algorithms or data structures with graph-like relationships, use precise terminology to de...
-
Use proper testing frameworks
open-telemetry/opentelemetry-python2⭐ 2061Always leverage established testing frameworks and APIs over custom bash scripts or direct Python execution...
-
Track observability API changes
open-telemetry/opentelemetry-python2⭐ 2061Stay informed about API changes in observability libraries like OpenTelemetry, especially during their acti...
-
Telemetry version pinning
open-telemetry/opentelemetry-python2⭐ 2061When specifying observability frameworks like OpenTelemetry in requirements files, use the compatible relea...
-
Adapt for linter compatibility
open-telemetry/opentelemetry-python2⭐ 2061When writing or modifying code, design patterns and templates to be compatible with linting tools. This is ...
-
Use authoritative data sources
commaai/openpilot2⭐ 58214When working with network-related data, always read from the most direct and authoritative source available...
-
Platform-specific socket configuration
commaai/openpilot2⭐ 58214When configuring TCP socket options, always check the platform and apply appropriate settings for each oper...
-
pin external action versions
commaai/openpilot2⭐ 58214Always pin external GitHub Actions to specific commit hashes rather than using tags or branch names, and pr...
-
Parameterize hardcoded API values
commaai/openpilot2⭐ 58214When designing APIs or interfaces, avoid hardcoding string literals, configuration values, or identifiers t...
-
optimize mathematical mappings
commaai/openpilot2⭐ 58214Use consistent units and data representations throughout mathematical calculations to avoid unnecessary com...
-
Optimize git network operations
commaai/openpilot2⭐ 58214When performing git operations that involve network communication, use proper syntax and efficient strategi...
-
maintain CI/CD parity
commaai/openpilot2⭐ 58214Ensure CI/CD pipeline tools run with the same configuration, flags, and behavior as developers use locally....
-
Explicit value specifications
commaai/openpilot2⭐ 58214Always use explicit value specifications and type-safe handling to prevent undefined behavior and ensure pr...
-
Design convenient APIs
commaai/openpilot2⭐ 58214APIs should provide convenient methods that handle common operations directly, rather than requiring users ...
-
Consistent terminology choices
commaai/openpilot2⭐ 58214When introducing new terminology or naming conventions, ensure consistency with existing patterns in the co...
-
Centralize error handling utilities
commaai/openpilot2⭐ 58214Create reusable error handling functions that accept custom error callbacks instead of duplicating error ha...
-
Cache expensive operations
commaai/openpilot2⭐ 58214Identify operations that are expensive and called frequently, then optimize them by caching results, moving...
-
Extract duplicated logic
opengrep/opengrep2⭐ 1546When you notice the same code pattern appearing in multiple places, extract it into a reusable function rat...
-
Ensure cross-platform compatibility
opengrep/opengrep2⭐ 1546Write code that works consistently across different platforms and environments. Avoid using Unicode symbols...
-
Thread-safe resource cleanup
opencv/opencv2⭐ 82865When implementing resource cleanup in concurrent applications, avoid using deprecated finalizers and instea...
-
Maintain build compatibility
opencv/opencv2⭐ 82865When modifying build scripts or configurations, ensure compatibility across all supported environments and ...
-
Document configuration version requirements
opencv/opencv2⭐ 82865Make build configuration options explicit and document their version dependencies. When introducing configu...
-
Check nulls directly
opencv/opencv2⭐ 82865Check objects directly for null/empty state instead of using separate tracking variables. Always perform nu...
-
validate AI model configurations
sst/opencode2⭐ 28213When adding or modifying AI model configurations, ensure proper validation through both pattern-based match...
-
Separate configuration concerns
sst/opencode2⭐ 28213Keep persistent user configuration separate from transient state, setup flags, and derived values. Persiste...
-
maintain JSON response consistency
sst/opencode2⭐ 28213When designing API responses that need to handle different data types or display states, maintain consisten...
-
Ensure proper error signaling
sst/opencode2⭐ 28213Errors must be communicated through appropriate mechanisms for their execution context. In CLI applications...
-
coordinate concurrent initialization
sst/opencode2⭐ 28213When implementing expensive initialization operations that may be triggered concurrently, use a shared prom...
-
Contextualize documentation decisions
sst/opencode2⭐ 28213Documentation should provide contextual guidance about when and why to use features, not just how to config...
-
Purpose-reflecting file names
ollama/ollama2⭐ 145705File names should clearly communicate their purpose and functionality. Avoid generic, ambiguous, or numbere...
-
Path traversal prevention
ollama/ollama2⭐ 145705Implement multiple validation layers to prevent path traversal attacks. File paths provided by users or ext...
-
Optimize memory allocations
ollama/ollama2⭐ 145705Be strategic about memory allocations to improve performance in your C++ code. Consider two key optimizatio...
-
Model precision matters
ollama/ollama2⭐ 145705When deploying AI models on specialized hardware accelerators (GPUs, NPUs), ensure you're using compatible ...
-
Keep container images current
ollama/ollama2⭐ 145705Always use up-to-date and supported container images in Dockerfiles and configuration files. Before specify...
-
Extract duplicated code
ollama/ollama2⭐ 145705Identify repeated code segments and extract them into reusable functions or variables. This improves mainta...
-
Complete HTTP protocol handling
ollama/ollama2⭐ 145705When implementing HTTP client functionality, ensure comprehensive support for all standard HTTP status code...
-
Complete documentation coverage
ollama/ollama2⭐ 145705Documentation should comprehensively cover all supported options, variations, and potential future use case...
-
AI dependency decoupling strategy
ollama/ollama2⭐ 145705Implement clear boundaries between your core AI system and external machine learning libraries through abst...
-
Verify documentation links
octokit/octokit.net2⭐ 2793Always ensure external links in documentation are valid, secure, and point to authoritative sources. This i...
-
Use appropriate framework targets
octokit/octokit.net2⭐ 2793When configuring .NET projects, always use the correct target framework elements and versions: 1. Use the ...
-
Secure permission modeling
octokit/octokit.net2⭐ 2793When implementing security-related models such as permissions, carefully design the properties to prevent u...
-
Precise and consistent naming
octokit/octokit.net2⭐ 2793Names should clearly indicate their specific purpose and context, while maintaining correct capitalization ...
-
File-specific indentation standards
octokit/octokit.net2⭐ 2793Maintain consistent indentation based on file type to ensure code readability and prevent unwanted whitespa...
-
Use precise terminology
nrwl/nx2⭐ 27518Always use specific, accurate terminology rather than vague or generic terms when naming sections, referenc...
-
Use explicit identifiers
nrwl/nx2⭐ 27518Choose explicit, unambiguous names for functions, variables, and parameters to avoid conflicts with common ...
-
Thread ownership clarity
nrwl/nx2⭐ 27518When designing concurrent systems, ensure data ownership is explicit and clear at thread boundaries. Avoid ...
-
synchronize declared versions
nrwl/nx2⭐ 27518Ensure that version declarations in configuration files accurately reflect the versions actually being used...
-
standardize TODO comments
nrwl/nx2⭐ 27518Use version-specific TODO comments with a consistent format to ensure actionable items are properly tracked...
-
Provide actionable error messages
nrwl/nx2⭐ 27518When handling errors, transform technical exceptions into user-friendly messages that include clear remedia...
-
organize testing documentation clearly
nrwl/nx2⭐ 27518Ensure testing documentation is properly categorized and uses precise terminology to maintain clarity and a...
-
externalize configuration values
nrwl/nx2⭐ 27518Configuration values should be externalized from code and read from standard locations like package.json or...
-
Ensure informative log messages
nrwl/nx2⭐ 27518Log messages should be clear, informative, and include specific details to help users understand what is ha...
-
Context-aware configuration logic
nrwl/nx2⭐ 27518Configuration logic should adapt based on environmental context rather than using static values. Examine th...
-
Clean CI configurations
nrwl/nx2⭐ 27518Maintain clean and well-documented CI configurations by removing dead code and properly documenting tempora...
-
cache isolation boundaries
nrwl/nx2⭐ 27518When documenting caching systems, clearly specify cache isolation boundaries and access scopes to prevent c...
-
Avoid runtime API calls
nrwl/nx2⭐ 27518Components should not make external API calls for data that can be pre-generated at build time. Instead of ...
-
API documentation accuracy
nrwl/nx2⭐ 27518Ensure API documentation examples use types, interfaces, and imports that actually exist in the documented ...
-
accessibility attributes for decorative elements
nrwl/nx2⭐ 27518Decorative images, icons, and other visual elements that don't convey meaningful content should include `ar...
-
Use proper HTTP utilities
nuxt/nuxt2⭐ 57769When handling HTTP cookies and headers, use dedicated utility functions instead of manual string manipulati...
-
semantic names with counters
nuxt/nuxt2⭐ 57769When generating unique identifiers that may have multiple instances, combine semantic base names with count...
-
safe error data handling
nuxt/nuxt2⭐ 57769When processing error data that may contain unsafe or undefined values, use safe parsing methods and defens...
-
Preserve HTTP header semantics
nuxt/nuxt2⭐ 57769HTTP headers have specific semantics that must be respected when processing, merging, or deduplicating them...
-
organize accessibility attributes
nuxt/nuxt2⭐ 57769Systematically organize HTML elements by adding appropriate accessibility attributes (aria-label, role) to ...
-
optimize CI/CD configurations
nuxt/nuxt2⭐ 57769Review CI/CD workflow configurations for both performance optimizations and accuracy in conditional logic. ...
-
improve code readability
nuxt/nuxt2⭐ 57769Add line breaks and proper spacing between logical blocks within functions to improve code readability. Whe...
-
Filter sensitive data server-side
nuxt/nuxt2⭐ 57769Always filter sensitive data at the API/server level before sending responses to the client. Never rely on ...
-
consistent code formatting
nuxt/nuxt2⭐ 57769Maintain consistent formatting standards across code and documentation to improve readability and maintaina...
-
conditional component bundling
nuxt/nuxt2⭐ 57769When adding conditional components to your application, ensure they are only bundled when actually needed t...
-
Use constructor.name context
novuhq/novu2⭐ 37700Always set logger context using `this.constructor.name` and configure it via the `setContext()` method rath...
-
Strategic error handling
novuhq/novu2⭐ 37700Implement strategic error handling by properly checking exception types and using try/catch blocks to disti...
-
Pin dependency versions
novuhq/novu2⭐ 37700Always pin dependency versions by removing caret (^) and tilde (~) prefixes in package.json files to preven...
-
Event listener management
novuhq/novu2⭐ 37700Implement comprehensive event listener management by registering listeners on multiple relevant sources and...
-
consistent authentication patterns
novuhq/novu2⭐ 37700Use standardized authentication decorators consistently across all endpoints to ensure proper security cove...
-
comprehensive null checks
novuhq/novu2⭐ 37700When checking for null or undefined values in conditional statements, ensure all related nullable dependenc...
-
avoid @Optional decorator
novuhq/novu2⭐ 37700Avoid using the @Optional decorator in NestJS dependency injection as it disables runtime DI validation dur...
-
Validate network request parameters
nodejs/node2⭐ 112178Always validate and sanitize all network request parameters to prevent injection attacks. This includes: 1...
-
Secure resource loading
nodejs/node2⭐ 112178Always validate and securely load external resources like libraries, configuration files, and modules to pr...
-
Descriptive behavior-based tests
nodejs/node2⭐ 112178Tests should be named to describe the expected behavior or outcome being verified, not the input parameters...
-
Choose appropriate containers
nodejs/node2⭐ 112178Select data structures based on expected collection size and usage patterns. For small collections (typical...
-
Validate Next.js Configuration Usage
vercel/next.js2⭐ 133000When implementing Next.js in your application, ensure that you are correctly using the framework's document...
-
Robust Error Handling in Next.js Components
vercel/next.js2⭐ 133000When building Next.js components, it is crucial to implement robust error handling to ensure the stability ...
-
Proper panic chains
vercel/next.js2⭐ 133000When implementing panic handlers, follow these critical practices to ensure robust error handling: register...
-
Non-blocking observability mechanisms
vercel/next.js2⭐ 133000When implementing observability mechanisms like telemetry or status monitoring, ensure they don't block or ...
-
Document configuration sources
vercel/next.js2⭐ 133000When providing configuration instructions, document the exact location and method to obtain required values...
-
Dependency conscious APIs
vercel/next.js2⭐ 133000Design APIs with dependency implications in mind. Carefully consider how your API design choices might forc...
-
Complete error handling flows
vercel/next.js2⭐ 133000Implement robust error handling patterns that ensure both proper resource cleanup and error context preserv...
-
Complete data structures
vercel/next.js2⭐ 133000When implementing data structures such as tries, trees, or graphs, ensure all critical operations (insertio...
-
Choose optimal data structures
vercel/next.js2⭐ 133000Select data structures based on their performance characteristics and actual usage patterns. When implement...
-
Validate parameter boundaries
ChatGPTNextWeb/NextChat2⭐ 85721Always validate that parameters contain expected types and values within safe boundaries, not just null/und...
-
React hooks best practices
ChatGPTNextWeb/NextChat2⭐ 85721Always call React hooks at the top level of components and custom hooks to comply with the Rules of Hooks. ...
-
Prevent security vulnerabilities
ChatGPTNextWeb/NextChat2⭐ 85721Proactively identify and prevent common security vulnerabilities in code, particularly around sensitive dat...
-
Package manager consistency
ChatGPTNextWeb/NextChat2⭐ 85721Maintain consistent package manager usage throughout the project lifecycle. When a project uses yarn (indic...
-
Implement stable sorting
ChatGPTNextWeb/NextChat2⭐ 85721When implementing sorting algorithms for collections, ensure stable and predictable ordering to avoid incon...
-
Consistent styling approach
ChatGPTNextWeb/NextChat2⭐ 85721Maintain consistency in styling approaches within components and across the codebase. Avoid mixing classNam...
-
Configuration backward compatibility
ChatGPTNextWeb/NextChat2⭐ 85721When modifying configuration schemas or adding new configuration options, always ensure backward compatibil...
-
Enable header validation
netty/netty2⭐ 34227Always enable HTTP header validation to prevent request/response splitting vulnerabilities. These attacks c...
-
Check feature compatibility
netty/netty2⭐ 34227When using kernel-specific networking features like io_uring, always implement runtime detection of feature...
-
Test dependency management
nestjs/nest2⭐ 71767Testing tools and libraries should be placed in `devDependencies` rather than regular dependencies in packa...
-
Manage testing dependencies
nestjs/nest2⭐ 71766Properly manage testing-related dependencies by placing them in devDependencies and regularly auditing them...
-
Document CI/CD changes
nestjs/nest2⭐ 71766Always document changes to CI/CD configurations and scripts, and ensure pull requests remain focused on the...
-
optimize data structure operations
neovim/neovim2⭐ 91433When working with data structures, prioritize efficiency through proper memory management and compact data ...
-
follow protocol standards
neovim/neovim2⭐ 91433When implementing network protocols or communication formats, prioritize standardized specifications over l...
-
Document connection scope
neovim/neovim2⭐ 91433When documenting network connection operations, clearly specify the scope of when operations are supported ...
-
defer expensive operations
neovim/neovim2⭐ 91433Avoid performing expensive operations (like module loading, event emissions, or resource allocation) until ...
-
avoid Lua ternary traps
neovim/neovim2⭐ 91433Avoid using the `condition and expr1 or expr2` pattern when `expr1` can be `nil` or `false`, as this will a...
-
API extensibility parameters
neovim/neovim2⭐ 91433Always design API functions with extensible parameter structures to accommodate future feature expansion wi...
-
Reliable concurrency synchronization
neondatabase/neon2⭐ 19015When handling concurrent operations, prefer completion signals and proper thread management over arbitrary ...
-
Proper metrics design
neondatabase/neon2⭐ 19015When designing metrics for observability systems like Prometheus, follow established best practices to ensu...
-
Optimize what matters
neondatabase/neon2⭐ 19015Focus optimization efforts on performance-critical paths rather than applying micro-optimizations everywher...
-
Modern shell syntax
neondatabase/neon2⭐ 19015Prefer double brackets (`[[ ]]`) over single brackets (`[ ]`) in shell scripts for improved functionality a...
-
Mind transaction boundaries
neondatabase/neon2⭐ 19015Be conscious of implicit transaction boundaries when working with databases. Programming constructs can cre...
-
Limit concurrent access slots
neondatabase/neon2⭐ 19015Design concurrency mechanisms based on actual usage patterns rather than theoretical maximum connections. W...
-
Handle network interrupts safely
neondatabase/neon2⭐ 19015Network code must properly handle interrupts and maintain consistent connection state at all potential inte...
-
Feature flag implementation clarity
neondatabase/neon2⭐ 19015When implementing feature flags in the system, clearly document both the evaluation strategy and its perfor...
-
Document parameter choices
neondatabase/neon2⭐ 19015Always add explanatory comments for parameters or configuration options that aren't self-explanatory from t...
-
Document connection transitions
neondatabase/neon2⭐ 19015When implementing systems that involve network connection state changes (such as during failovers, restarts...
-
Database replica promotion safeguards
neondatabase/neon2⭐ 19015When implementing database replica promotion logic, avoid temporary workarounds that bypass validation chec...
-
Balance flexibility with performance
neondatabase/neon2⭐ 19015When designing APIs, carefully balance flexibility against performance constraints. More flexible APIs ofte...
-
Sanitize user input
n8n-io/n8n2⭐ 122978Always sanitize and validate user-controlled input before using it in sensitive operations, and never hard-...
-
Remove commented code immediately
n8n-io/n8n2⭐ 122978Commented-out code should be removed immediately rather than committed to the codebase. Keeping commented c...
-
Preserve icon font families
n8n-io/n8n2⭐ 122978When working with icon elements in CSS, maintain the specialized font families designed for icon rendering....
-
Optimize Vue watchers
n8n-io/n8n2⭐ 122978When implementing watchers in Vue applications, ensure they are configured appropriately for the data struc...
-
Avoid hardcoded configurations
n8n-io/n8n2⭐ 122978Never hardcode environment-specific values or feature states directly in your code. Instead, use environmen...
-
Use pytest parameterization
apache/mxnet2⭐ 20801Structure unit tests using pytest's parameterize decorator instead of manual loops or wrapper functions. Th...
-
Use named constants
apache/mxnet2⭐ 20801In AI model implementations, avoid using magic numbers directly in code as they reduce readability and make...
-
Pre-compute reused data
apache/mxnet2⭐ 20801When data will be accessed multiple times during processing, avoid redundant calculations by pre-computing ...
-
Consistent API documentation
apache/mxnet2⭐ 20801Maintain high-quality, consistent documentation as a critical component of API design. Documentation should...
-
avoid stale ref values
rocicorp/mono2⭐ 2091When using React refs in hooks like useLayoutEffect or useEffect, pass the ref object itself rather than re...
-
avoid manual error handling
rocicorp/mono2⭐ 2091Prefer centralized error handling mechanisms and specialized utilities over manual error handling in indivi...
-
avoid global state
rocicorp/mono2⭐ 2091Avoid global state in concurrent environments where multiple instances, workers, or clients may share the s...
-
API parameter design
rocicorp/mono2⭐ 2091When designing API functions and types, prioritize maintainability and extensibility through proper paramet...
-
Write timeless documentation
mui/material-ui2⭐ 96063Documentation should be written to remain clear and useful regardless of when it's read. Avoid references t...
-
Use screen queries
mui/material-ui2⭐ 96063When writing component tests, prefer using global `screen` queries from Testing Library instead of containe...
-
Use direct path imports
mui/material-ui2⭐ 96063For optimal performance, use direct path imports instead of barrel imports when working with UI component l...
-
Secure API endpoints
mui/material-ui2⭐ 96063Always implement appropriate security measures for API endpoints that perform sensitive operations. This in...
-
Prefer direct property access
mui/material-ui2⭐ 96063When property names are known at development time, use direct property access (e.g., `object.property`) ove...
-
Parameterize build processes
mui/material-ui2⭐ 96063When designing build scripts for multi-package repositories, use parameterization to handle special cases r...
-
Parameter interaction design
mui/material-ui2⭐ 96063Design APIs with clear parameter interactions and priority rules to create intuitive interfaces. When multi...
-
Optimize CI/CD infrastructure
mui/material-ui2⭐ 96063Continuously optimize and maintain your CI/CD infrastructure to keep development velocity high while ensuri...
-
Next.js integration patterns
mui/material-ui2⭐ 96063When integrating with Next.js, follow framework-specific patterns carefully and stay updated with API chang...
-
Isolate DOM security boundaries
mui/material-ui2⭐ 96063When developing UI components, establish clear DOM manipulation boundaries to prevent security risks. Compo...
-
Graceful component errors
mui/material-ui2⭐ 96063Use descriptive error messages and appropriate error severity based on component maturity and usage pattern...
-
Follow library recommendations
mui/material-ui2⭐ 96063When writing tests, prioritize following the official recommendations and best practices of testing librari...
-
Document design decisions
mui/material-ui2⭐ 96063When making architectural choices or modifying existing APIs, document your reasoning directly in the code ...
-
Consistent package naming
mui/material-ui2⭐ 96063Use consistent and meaningful naming patterns for packages based on their purpose, visibility, and scope. T...
-
Use semantic null handling
mastodon/mastodon2⭐ 48691When designing APIs and data structures, be intentional about null and undefined usage. Use null and undefi...
-
Safe proxy configuration
mastodon/mastodon2⭐ 48691When configuring proxy settings for network applications, always use proper compilation methods to prevent ...
-
Review configuration currency
mastodon/mastodon2⭐ 48691Regularly audit and update configuration to align with current tool capabilities and best practices. Remove...
-
remove redundant code
mastodon/mastodon2⭐ 48691Identify and remove code elements that no longer serve a purpose, including unused imports, redundant funct...
-
prefer findBy async queries
mastodon/mastodon2⭐ 48691When testing components that require waiting for elements to appear, prefer using findBy* queries over wait...
-
prefer established configuration patterns
mastodon/mastodon2⭐ 48691When making configuration choices, prioritize existing centralized configuration values and established pat...
-
Optimize React hooks
mastodon/mastodon2⭐ 48691Avoid unnecessary useCallback and useEffect dependencies to improve performance and code clarity. When even...
-
Minimize HTML attack surface
mastodon/mastodon2⭐ 48691When allowing HTML attributes or rendering user-generated content, explicitly limit the attack surface by r...
-
markdown formatting consistency
mastodon/mastodon2⭐ 48691Establish and maintain consistent formatting standards for Markdown files to improve readability and mainta...
-
leverage build tool automation
mastodon/mastodon2⭐ 48691Modern build tools like Vite automatically handle many performance optimizations that previously required m...
-
Framework-aware text composition
mastodon/mastodon2⭐ 48691When writing user-facing text (error messages, notifications, labels), understand how your framework automa...
-
Environment variable descriptive naming
mastodon/mastodon2⭐ 48691Environment variables should use descriptive, specific names that clearly indicate their purpose and scope ...
-
Documentation audience appropriateness
mastodon/mastodon2⭐ 48691Ensure documentation content matches its intended audience and location. High-level documentation like READ...
-
consistent route nesting
mastodon/mastodon2⭐ 48691Maintain consistent URL patterns and nesting structures across similar API endpoints to ensure predictable ...
-
consistent dependency versioning
mastodon/mastodon2⭐ 48691Maintain consistent version constraint patterns across all dependencies in configuration files and avoid un...
-
Configuration value safety
mastodon/mastodon2⭐ 48691Ensure configuration values are properly encoded and dependencies use specific versions to prevent runtime ...
-
comprehensive authorization checks
mastodon/mastodon2⭐ 48691Always implement thorough authorization checks at the earliest appropriate point in request processing, rat...
-
complete React ESLint setup
mastodon/mastodon2⭐ 48691When configuring ESLint for React projects, ensure you include comprehensive React-specific configurations ...
-
avoid redundant computations
mastodon/mastodon2⭐ 48691Identify and eliminate computations that are performed repeatedly when they could be executed once. This in...
-
avoid deprecated SASS syntax
mastodon/mastodon2⭐ 48691Always use modern SASS and CSS syntax instead of deprecated functions to ensure future compatibility and av...
-
accessibility interaction security
mastodon/mastodon2⭐ 48691Ensure that accessibility features do not create security vulnerabilities by allowing unintended interactio...
-
Validate configuration assumptions
microsoft/markitdown2⭐ 76602Before adding or modifying configuration settings, understand the underlying tool capabilities and test you...
-
validate before processing
microsoft/markitdown2⭐ 76602Always validate input state and types before performing operations to prevent runtime errors and unexpected...
-
Handle async concurrency properly
microsoft/markitdown2⭐ 76602When writing async endpoints, ensure that long-running CPU-bound operations don't block the event loop and ...
-
Follow configuration best practices
microsoft/markitdown2⭐ 76602Always adhere to official guidelines and proper validation when setting up configurations, whether for depe...
-
Variable evaluation context
maplibre/maplibre-native2⭐ 1411Be mindful of when and where environment variables and configuration values are evaluated in shell scripts,...
-
Use specific test assertions
maplibre/maplibre-native2⭐ 1411Always use the most specific test assertion method available for your test case rather than generic asserti...
-
Style-compliant example code
maplibre/maplibre-native2⭐ 1411Example code in documentation and tutorials should adhere to project style guidelines and demonstrate best ...
-
Standard configuration files
maplibre/maplibre-native2⭐ 1411Use standardized, tool-specific configuration files instead of embedding configurations in CI scripts or ot...
-
Optimize compilation flags
maplibre/maplibre-native2⭐ 1411When optimizing application performance, carefully select compiler flags based on your optimization goals. ...
-
Numerical precision considerations
maplibre/maplibre-native2⭐ 1411When implementing algorithms involving floating-point calculations, choose epsilon values based on the spec...
-
Lock responsibly, always
maplibre/maplibre-native2⭐ 1411Ensure proper management of locks and concurrent resources throughout their lifecycle. When implementing co...
-
Document containerized builds
maplibre/maplibre-native2⭐ 1411When using Docker for build environments, provide complete, tested instructions that users can copy-paste w...
-
Cross-platform test management
maplibre/maplibre-native2⭐ 1411When working with tests that run across multiple platforms (iOS, Android, etc.), ensure proper configuratio...
-
Configuration over hardcoding
maplibre/maplibre-native2⭐ 1411When designing APIs, prefer exposing behavior through configuration options rather than hardcoding logic, e...
-
Conditional observability instrumentation
maplibre/maplibre-native2⭐ 1411Wrap all tracing, profiling, and debugging instrumentation in appropriate conditional compilation blocks (l...
-
Accurate documentation references
maplibre/maplibre-native2⭐ 1411Ensure all code documentation includes appropriate reference links that are current and accurate. When port...
-
Strategic dependency versioning
logseq/logseq2⭐ 37695Use strategic versioning approaches for dependencies based on their impact and maintenance status. Pin exac...
-
Simplify naming conventions
logseq/logseq2⭐ 37695Prioritize simple, enforceable naming conventions over complex guidelines that are difficult to follow cons...
-
Respect existing formatting
logseq/logseq2⭐ 37695When modifying existing files, maintain the formatting and style conventions already established in those f...
-
Prevent command injection vulnerabilities
logseq/logseq2⭐ 37695When implementing shell command execution or CLI features, prioritize security by avoiding direct shell exe...
-
Extract reusable hooks
logseq/logseq2⭐ 37695When you identify React logic that handles complex state management or event handling patterns that could b...
-
CSS comment standards
logseq/logseq2⭐ 37695Always use proper CSS comment syntax (`/* */`) instead of inline comments (`//`) for better cross-browser c...
-
Check undefined before use
logseq/logseq2⭐ 37695Always verify that values are not undefined before accessing or using them, whether they are object propert...
-
Verify configuration documentation
lobehub/lobe-chat2⭐ 65138Ensure that all configuration documentation accurately reflects the actual implementation, especially for b...
-
Use semantic naming
lobehub/lobe-chat2⭐ 65138Choose names that reflect purpose and meaning rather than visual appearance, position, or implementation de...
-
Respect browser behavior
lobehub/lobe-chat2⭐ 65138Always consider and respect browser native behaviors when implementing web application features. Avoid conf...
-
Provide contextual guidance
lobehub/lobe-chat2⭐ 65138Documentation should provide clear contextual information that helps users understand when they need to tak...
-
Pin Docker base versions
lobehub/lobe-chat2⭐ 65138Always specify exact version numbers for Docker base images instead of using floating tags like `lts` or `l...
-
Next.js auth configuration
lobehub/lobe-chat2⭐ 65138Follow auth.js standardized environment variable naming conventions and use explicit function declarations ...
-
Explicit type checking
lobehub/lobe-chat2⭐ 65138Use explicit type checks instead of just undefined checks to prevent null values from being passed to funct...
-
Environment-specific configuration handling
lobehub/lobe-chat2⭐ 65138When writing configuration scripts, ensure they handle environment-specific differences properly by using p...
-
Contextual error handling
lobehub/lobe-chat2⭐ 65138Implement error handling that is both architecturally localized and contextually specific to provide better...
-
Choose hooks wisely
lobehub/lobe-chat2⭐ 65138Use React hooks only when you need reactivity and component re-rendering. For accessing instantaneous value...
-
Account for model variations
lobehub/lobe-chat2⭐ 65138When implementing features that interact with AI models, consider the behavioral differences between variou...
-
Simplify configuration interfaces
LMCache/LMCache2⭐ 3800Design configuration interfaces that prioritize user experience by providing sensible defaults, using clear...
-
Remove redundant AI commands
LMCache/LMCache2⭐ 3800Eliminate duplicate or redundant commands when setting up AI infrastructure, model serving, or ML library i...
-
network service identification
LMCache/LMCache2⭐ 3800Use descriptive string identifiers instead of numeric ports or generic IDs when designing network services ...
-
Check before using values
LMCache/LMCache2⭐ 3800Always validate that values are not null, undefined, or empty before using them in operations that depend o...
-
Avoid hardcoded configuration values
LMCache/LMCache2⭐ 3800Configuration files and scripts should use placeholders, environment variables, or parameterized values ins...
-
Write accessible documentation
llvm/llvm-project2⭐ 33702Documentation should be written with clarity and completeness to serve readers who may not have deep domain...
-
structure contextual log messages
llvm/llvm-project2⭐ 33702Log messages should include sufficient contextual information and structured formatting to enable effective...
-
specify network protocol endianness
llvm/llvm-project2⭐ 33702Always explicitly specify byte order (endianness) in network protocol documentation and implementations. Ev...
-
preserve known test issues
llvm/llvm-project2⭐ 33702When tests exhibit known false positives or false negatives, preserve these test cases with clear documenta...
-
Match function names to behavior
llvm/llvm-project2⭐ 33702Function names and their documentation must accurately reflect what the function actually does. When a func...
-
match API complexity appropriately
llvm/llvm-project2⭐ 33702Design APIs with complexity that matches their actual use cases and adopt established patterns that improve...
-
improve code readability
llvm/llvm-project2⭐ 33702When code expressions become complex or difficult to understand at first glance, refactor them for better r...
-
explicit invalid value handling
llvm/llvm-project2⭐ 33702When designing enums or working with type casting, explicitly define and handle invalid states rather than ...
-
Explicit configuration requirements
llvm/llvm-project2⭐ 33702Always specify explicit configuration parameters rather than relying on default settings that may vary acro...
-
Ensure comprehensive documentation
llvm/llvm-project2⭐ 33702Documentation should be complete, properly formatted, and clearly explain purpose with adequate examples. W...
-
consistent error diagnostics
llvm/llvm-project2⭐ 33702When implementing attributes, language features, or compiler diagnostics, always provide explicit error dia...
-
Choose appropriate string types
llvm/llvm-project2⭐ 33702Select the most efficient string type based on ownership and lifetime requirements to optimize memory usage...
-
Use strongly typed configurations
ggml-org/llama.cpp2⭐ 83559Prefer strongly typed configuration values over primitive types to improve code safety and clarity. Use enu...
-
Use precise documentation details
ggml-org/llama.cpp2⭐ 83559Documentation should provide specific, actionable information rather than vague or generic references. This...
-
Use environment variables
ggml-org/llama.cpp2⭐ 83559Prefer environment variables over hardcoded paths and configuration values in build scripts and configurati...
-
Specify naming formats explicitly
ggml-org/llama.cpp2⭐ 83559When defining naming conventions in documentation, specifications, or APIs, explicitly specify the exact fo...
-
semantic configuration validation
ggml-org/llama.cpp2⭐ 83559When designing configuration systems, prefer semantic parameters over generic key-value approaches for comm...
-
prefer const variables
ggml-org/llama.cpp2⭐ 83559Add the `const` qualifier to variables that are not modified after initialization. This improves code clari...
-
optimize code placement
ggml-org/llama.cpp2⭐ 83559Ensure code is placed in its most logical and efficient location to improve maintainability and performance...
-
implement or fail explicitly
ggml-org/llama.cpp2⭐ 83559Algorithmic functions should either correctly implement their intended behavior or explicitly fail with an ...
-
explicit performance handling
ggml-org/llama.cpp2⭐ 83559When writing performance benchmarking and measurement code, always be explicit about all possible cases and...
-
Enable callback chaining
ggml-org/llama.cpp2⭐ 83559When designing APIs that accept callbacks or configuration functions, always return the previous callback/c...
-
consistent clear naming
ggml-org/llama.cpp2⭐ 83559Ensure variable and identifier names are both consistent and unambiguous within their context. When multipl...
-
Prioritize naming clarity
BerriAI/litellm2⭐ 28310Choose names that are immediately self-explanatory and unambiguous, even if they are more verbose. Names sh...
-
Incremental dependency updates
BerriAI/litellm2⭐ 28310When updating dependencies in configuration files like requirements.txt, break large changes into smaller, ...
-
Follow documentation standards
BerriAI/litellm2⭐ 28310Ensure all documentation follows established patterns and standards for components, formatting, and code ex...
-
Document configuration purpose clearly
BerriAI/litellm2⭐ 28310When documenting configuration features, always provide clear explanations of their purpose, use cases, and...
-
configurable security settings
BerriAI/litellm2⭐ 28310Security configurations should be made configurable through environment variables or runtime settings rathe...
-
Use semantic identifiers
torvalds/linux2⭐ 197350Choose semantically appropriate identifiers and types that clearly represent their purpose. This includes u...
-
Prefer early returns
torvalds/linux2⭐ 197350When a function can determine an early result based on input validation or special cases, return immediatel...
-
Proper configuration placement
langfuse/langfuse2⭐ 13574Place configuration files and settings at the appropriate level in your repository structure. In monorepos,...
-
Materialize database indexes
langfuse/langfuse2⭐ 13574Always materialize database indexes after creation to ensure they are fully built and immediately available...
-
Consistent descriptive naming
langfuse/langfuse2⭐ 13574Use naming conventions that are both consistent with existing patterns and descriptively clear about purpos...
-
Capitalize acronyms consistently
langfuse/langfuse2⭐ 13574Use standard capitalization for acronyms in all identifiers, method names, variables, and other code elemen...
-
Validate migration conflicts
langflow-ai/langflow2⭐ 111046Before applying database migrations, systematically validate existing data and check for potential conflict...
-
validate API inputs comprehensively
langflow-ai/langflow2⭐ 111046Ensure thorough validation of API inputs and outputs using robust validation techniques rather than simple ...
-
Standardize naming patterns consistently
langflow-ai/langflow2⭐ 111046Establish and follow consistent naming conventions for similar types of elements throughout the codebase an...
-
sanitize trace metadata
langflow-ai/langflow2⭐ 111046Always sanitize trace metadata and attributes before sending to observability platforms to ensure compatibi...
-
precise workflow conditions
langflow-ai/langflow2⭐ 111046When implementing conditional logic in CI workflows, ensure boolean expressions are precise and comprehensi...
-
Implement concurrent safety patterns
langflow-ai/langflow2⭐ 111046When designing concurrent systems, implement comprehensive safety patterns that handle resource lifecycle m...
-
Ensure comprehensive test coverage
langflow-ai/langflow2⭐ 111046Always add test coverage for new functionality, especially when introducing integrations or services. Use m...
-
Document log level options
langflow-ai/langflow2⭐ 111046When documenting logging configuration parameters, always provide the complete list of available log level ...
-
Document implementation reasoning
langflow-ai/langflow2⭐ 111046Add comments that explain WHY implementation decisions were made, not just WHAT the code does. This is espe...
-
Database session lifecycle
langflow-ai/langflow2⭐ 111046Ensure all database operations and access to database objects occur within the appropriate session scope. D...
-
Comprehensive coverage collection
langflow-ai/langflow2⭐ 111046Configure Jest to collect coverage data from all source files, not just those with existing tests, while av...
-
avoid internal object access
langflow-ai/langflow2⭐ 111046Avoid accessing internal object attributes like `__dict__` or using unpacking syntax when cleaner alternati...
-
Update documentation configuration
langchain-ai/langchainjs2⭐ 15004When adding new files or components to the project, ensure that documentation configuration is updated acco...
-
Simplify code organization
langchain-ai/langchainjs2⭐ 15004Maintain clean code organization by eliminating unnecessary abstractions and preventing codebase fragmentat...
-
Platform-appropriate environment variables
langchain-ai/langchainjs2⭐ 15004Always use the correct syntax for accessing environment variables based on the target platform. In JavaScri...
-
Match configuration documentation
langchain-ai/langchainjs2⭐ 15004Configuration documentation must accurately reflect implementation details and behavior. Ensure that: 1. C...
-
Follow standard naming
langchain-ai/langchainjs2⭐ 15004Use established naming patterns and correct capitalization throughout the codebase and documentation. For...
-
Benchmark performance changes
kubernetes/kubernetes2⭐ 116489Always measure and validate performance impact through benchmarking before making changes that could affect...
-
Validate model optimization
kubeflow/kubeflow2⭐ 15064When implementing AI model optimization techniques such as early stopping algorithms or hyperparameter tuni...
-
Validate inputs explicitly
kubeflow/kubeflow2⭐ 15064Always validate input parameters and respond with appropriate HTTP status codes when invalid values are det...
-
Use enums for state
kubeflow/kubeflow2⭐ 15064When handling nullable or undefined states, use enumerations instead of primitive types like boolean or nul...
-
Use CSS classes properly
kubeflow/kubeflow2⭐ 15064Avoid inline styles and `!important` declarations in your HTML templates. Instead, define and use CSS class...
-
Unique workflow step names
kubeflow/kubeflow2⭐ 15064When defining CI/CD workflows, always ensure task/step names are unique to prevent execution failures. Work...
-
Type-appropriate default values
kubeflow/kubeflow2⭐ 15064Initialize variables with type-appropriate default values to prevent type errors and null reference excepti...
-
Standardize style scripts
kubeflow/kubeflow2⭐ 15064Maintain consistent code style enforcement scripts across all projects by standardizing linting and formatt...
-
Standardize metrics collection
kubeflow/kubeflow2⭐ 15064Use the appropriate metric types for the data being collected and consider centralizing monitoring code to ...
-
Stable configuration management
kubeflow/kubeflow2⭐ 15064Always ensure configuration values are managed consistently and sourced from stable locations. 1. Use def...
-
Safe URL operations
kubeflow/kubeflow2⭐ 15064When handling URLs for API interactions and navigation, use precise methods for both comparison and constru...
-
Reduce nesting depth
kubeflow/kubeflow2⭐ 15064Improve code readability by reducing nesting depth with early returns and functional approaches. Use early ...
-
Private variable naming convention
kubeflow/kubeflow2⭐ 15064Use the 'prv' prefix for private class members and ensure they're explicitly declared with the 'private' ac...
-
Prefer external configuration
kubeflow/kubeflow2⭐ 15064Design applications to use external configuration sources rather than hardcoding values directly in source ...
-
Optimize container build configurations
kubeflow/kubeflow2⭐ 15064Configure containerized application builds to be efficient and flexible by avoiding hardcoded architecture ...
-
Match algorithms to purpose
kubeflow/kubeflow2⭐ 15064Select algorithmic constructs and control structures that are appropriate for the specific task. Common iss...
-
Isolate test cases
kubeflow/kubeflow2⭐ 15064Create separate test functions for distinct functionality to improve test clarity and make failure points m...
-
Enforce least privilege
kubeflow/kubeflow2⭐ 15064Configure all systems with the minimum permissions required to function. For Kubernetes deployments, use se...
-
Document networking annotations
kubeflow/kubeflow2⭐ 15064When using Istio or other networking-related annotations in configuration files, always include detailed co...
-
Document migration paths
kubeflow/kubeflow2⭐ 15064When implementing version changes or migrations, provide comprehensive documentation and tools to support u...
-
Descriptive consistent naming
kubeflow/kubeflow2⭐ 15064Use descriptive and consistent names throughout the codebase. Prefer full, meaningful names over acronyms o...
-
Consistent separator conventions
kubeflow/kubeflow2⭐ 15064Use appropriate separators in compound identifiers to improve readability and ensure naming consistency acr...
-
Consistent descriptive naming
kubeflow/kubeflow2⭐ 15064Maintain consistency in naming patterns across related resources while ensuring names accurately reflect th...
-
Component-agnostic styling principles
kubeflow/kubeflow2⭐ 15064Create reusable components with styles that don't make assumptions about parent contexts or affect their po...
-
Centralize dependency configurations
kubeflow/kubeflow2⭐ 15064When adding or updating package dependencies, place them in centralized configuration files rather than dup...
-
Automate style enforcement
kubeflow/kubeflow2⭐ 15064Configure your development environment to automatically enforce code style standards rather than relying on...
-
API structure balance
kubeflow/kubeflow2⭐ 15064Maintain a clear separation between resource-specific API handlers and common utilities. Resource-specific ...
-
Use modern test infrastructure
JetBrains/kotlin2⭐ 50857Always add new tests to the current recommended test infrastructure rather than legacy systems that are bei...
-
Minimize not-null assertions
JetBrains/kotlin2⭐ 50857Avoid using not-null assertions (`!!`) when safer alternatives exist. Instead: 1. Use safe calls (`?.`) whe...
-
Dependency verification configuration
JetBrains/kotlin2⭐ 50857When adding new dependencies to build.gradle.kts files, always update the corresponding verification metada...
-
Copy external string inputs
JetBrains/kotlin2⭐ 50857When storing string pointers from external sources (like command-line arguments), always validate the input...
-
prefer simple null-safe patterns
kilo-org/kilocode2⭐ 7302Use straightforward null-safe patterns instead of complex undefined/empty distinctions. Avoid `any` types t...
-
organize test setup
kilo-org/kilocode2⭐ 7302Reduce test code duplication by organizing common setup logic and grouping related tests appropriately. Mov...
-
Justify configuration overrides
kilo-org/kilocode2⭐ 7302Before adding manual configuration entries, verify that the tool doesn't already provide the desired behavi...
-
Follow consistent semantic naming
kilo-org/kilocode2⭐ 7302Ensure that names accurately reflect their purpose and maintain consistency with established patterns in th...
-
Ensure proper React keys
kilo-org/kilocode2⭐ 7302Always provide meaningful keys for React components and fragments to ensure proper rendering and re-renderi...
-
enhance poor error messages
kilo-org/kilocode2⭐ 7302When external APIs or dependencies provide cryptic or unhelpful error messages, wrap them with user-friendl...
-
Document performance tool lifecycle
kilo-org/kilocode2⭐ 7302When creating performance optimization tools, especially temporary dev-only utilities, clearly document the...
-
Document configuration requirements
kilo-org/kilocode2⭐ 7302Always document configuration requirements, environment variables, and version specifications to ensure con...
-
Consider semantic context
kilo-org/kilocode2⭐ 7302When choosing names for variables, methods, classes, or configuration sections, consider both the current p...
-
Consider async function contracts
kilo-org/kilocode2⭐ 7302Be intentional when marking functions as async, as it changes the function's contract and caller expectatio...
-
Configuration bounds validation
kilo-org/kilocode2⭐ 7302Always validate configuration values against system limits and constraints, implementing automatic adjustme...
-
avoid expensive operations
kilo-org/kilocode2⭐ 7302Identify and mitigate costly operations that can significantly impact performance. This includes CPU-intens...
-
Document precise security requirements
apache/kafka2⭐ 30575Security documentation must specify exact permission requirements with clear scope and timing details. Vagu...
-
Document configuration constraints
apache/kafka2⭐ 30575Configuration documentation must explicitly specify when settings should or should not be used, including c...
-
condition-based network synchronization
apache/kafka2⭐ 30575When waiting for network state propagation or distributed system synchronization, avoid using fixed sleep t...
-
comprehensive test assertions
apache/kafka2⭐ 30575Write test assertions that are both comprehensive and maintainable. Ensure all relevant fields and behavior...
-
Centralize configuration values
apache/kafka2⭐ 30575Avoid duplicating configuration values across multiple files by maintaining a single source of truth for en...
-
avoid overly specific examples
apache/kafka2⭐ 30575When documenting configuration options, use generic examples that don't unnecessarily tie documentation to ...
-
API response completeness
apache/kafka2⭐ 30575Ensure API responses contain all necessary data fields and provide mechanisms for clients to verify operati...
-
Verify test assertions
jj-vcs/jj2⭐ 21171Always use appropriate assertion methods in tests to ensure proper verification of command behavior. When y...
-
specify configuration scope
jj-vcs/jj2⭐ 21171Always explicitly specify the configuration scope using `--user` or `--repo` flags when setting configurati...
-
require explicit security consent
jj-vcs/jj2⭐ 21171Always require explicit user consent and validation before executing potentially dangerous operations, espe...
-
precise algorithmic terminology
jj-vcs/jj2⭐ 21171When documenting or describing algorithmic operations, use precise, unambiguous terminology that clearly di...
-
Pin actions to commits
jj-vcs/jj2⭐ 21171Use specific commit hashes instead of version tags when referencing GitHub Actions in CI/CD workflows. Vers...
-
optimize remote fetch operations
jj-vcs/jj2⭐ 21171When implementing network operations that fetch data from remote sources, configure specific refspecs or pa...
-
Multiple remote configuration
jj-vcs/jj2⭐ 21171When documenting or implementing features that involve multiple remote repositories, provide clear guidance...
-
GitHub Actions security review
jj-vcs/jj2⭐ 21171Always review GitHub Actions workflows for security implications before merging, particularly focusing on a...
-
ensure cross-platform compatibility
jj-vcs/jj2⭐ 21171When creating configuration files and build tasks, prioritize cross-platform compatibility by avoiding shel...
-
document test configurations
jj-vcs/jj2⭐ 21171When modifying test configurations or tooling settings, provide clear explanations of what the changes actu...
-
Use platform-specific endpoints
menloresearch/jan2⭐ 37620When configuring API integrations, always use the actual platform-specific endpoints and identifiers rather...
-
Use centralized model state
menloresearch/jan2⭐ 37620Always access AI model information, parameters, and configuration through centralized state management rath...
-
Use centralized logging framework
menloresearch/jan2⭐ 37620Always use the established logging infrastructure instead of creating custom logging solutions or multiple ...
-
simplify error handling
menloresearch/jan2⭐ 37620Write concise and appropriate error handling code by avoiding unnecessary complexity and verbose constructi...
-
leverage existing solutions
menloresearch/jan2⭐ 37620Avoid duplicating functionality by leveraging existing libraries and creating reusable components. Instead ...
-
externalize configuration values
menloresearch/jan2⭐ 37620Configuration values, especially sensitive data like API keys and environment-specific settings, should be ...
-
Ensure proper event sequencing
menloresearch/jan2⭐ 37620When working with event-driven systems, ensure that events are emitted at the appropriate time and in the c...
-
consolidate build scripts
menloresearch/jan2⭐ 37620When creating multiple build variants (debug, publish, etc.), avoid duplicating build commands by reusing t...
-
consistent localhost addressing
menloresearch/jan2⭐ 37620Use 127.0.0.1 instead of 'localhost' for network requests and implement broad localhost detection rather th...
-
API interface consistency
menloresearch/jan2⭐ 37620Ensure that API function signatures, return types, and interface implementations are consistent and properl...
-
verify logging configuration functionality
istio/istio2⭐ 37192Ensure that logging configuration options actually perform the behavior their names suggest and provide rea...
-
validate access scope
istio/istio2⭐ 37192When implementing security features that involve access control, authentication, or authorization, carefull...
-
Security behavior clarity
istio/istio2⭐ 37192When documenting or describing security-related changes, especially bug fixes and behavioral modifications,...
-
optimize hot path performance
istio/istio2⭐ 37192Identify and eliminate expensive operations in frequently executed code paths, particularly in packet proce...
-
Flexible configuration defaults
istio/istio2⭐ 37192Configuration values should provide sensible defaults while remaining adaptable to different environments a...
-
Document observability clearly
istio/istio2⭐ 37192Ensure observability documentation is clear, accessible, and grammatically correct. This includes defining ...
-
Verify package.json accuracy
vadimdemedes/ink2⭐ 31825Ensure that package.json configuration entries accurately reflect the actual project structure and include ...
-
useEffect for measurements
vadimdemedes/ink2⭐ 31825When using functions that depend on rendered layout or DOM measurements, call them within useEffect hooks t...
-
Use React.FC consistently
vadimdemedes/ink2⭐ 31825Use React.FC (or React.FunctionComponent) for typing functional components instead of verbose function type...
-
Use descriptive parameter names
vadimdemedes/ink2⭐ 31825Choose parameter names that clearly communicate their purpose and avoid confusion with similar concepts. Av...
-
React interface clarity
vadimdemedes/ink2⭐ 31825Ensure React interfaces have descriptive names and accurate documentation that clearly communicate their pu...
-
optimize iteration patterns
vadimdemedes/ink2⭐ 31825When implementing loops and iteration logic, evaluate whether your current approach is the most efficient a...
-
Ensure documentation usability
vadimdemedes/ink2⭐ 31825Documentation should be practical and serve its intended audience effectively. Examples must be runnable ou...
-
Documentation quality standards
vadimdemedes/ink2⭐ 31825Ensure documentation follows proper formatting standards and provides complete, practical information for d...
-
Documentation code quality
vadimdemedes/ink2⭐ 31825Ensure documentation code blocks use appropriate syntax highlighting and provide comprehensive, functional ...
-
Clear API interfaces
vadimdemedes/ink2⭐ 31825Ensure API interfaces are clearly defined with proper formatting and comprehensive documentation. Type defi...
-
Document versioning strategies
influxdata/influxdb2⭐ 30268Establish and clearly document versioning strategies in configuration files, both for your application and ...
-
Document function signatures
influxdata/influxdb2⭐ 30268Always document function parameters and return values in the function header comment or interface definitio...
-
Centralize workspace configurations
influxdata/influxdb2⭐ 30268Centralize configuration settings like dependency versions and feature flags at the workspace level rather ...
-
Semantic naming consistency
elie222/inbox-zero2⭐ 8267Ensure all model and field names semantically reflect their actual purpose and maintain consistency with th...
-
Ensure schema-migration consistency
elie222/inbox-zero2⭐ 8267When modifying database schemas, ensure complete alignment between schema definitions and SQL migration scr...
-
Eliminate documentation redundancy
elie222/inbox-zero2⭐ 8267Documentation should be concise and avoid repeating the same information in multiple places. Redundant cont...
-
Consistent code organization
elie222/inbox-zero2⭐ 8267Maintain consistent patterns when organizing code elements within schema files. Place standard fields (like...
-
Collections use plural names
elie222/inbox-zero2⭐ 8267Always use plural names for properties representing collections (arrays/lists) in interfaces, types, and de...
-
weak pointer callback safety
hyprwm/Hyprland2⭐ 28863When capturing objects in callbacks or lambdas that may execute asynchronously, use weak pointers instead o...
-
validate environment variables
hyprwm/Hyprland2⭐ 28863Always validate that environment variables are properly defined and consistently named before using them in...
-
optimize workflow triggers
hyprwm/Hyprland2⭐ 28863Design CI/CD workflows with intentional triggers and conditions to avoid unnecessary executions, rate limit...
-
Explain documentation rationale
hyprwm/Hyprland2⭐ 28863When writing user-facing documentation, always explain WHY a guideline or requirement exists, not just WHAT...
-
Avoid unintentional defaults
hyprwm/Hyprland2⭐ 28863When designing configuration interfaces, be intentional about default values and consider their impact on u...
-
API input/output validation
hyprwm/Hyprland2⭐ 28863Ensure robust parsing of API inputs and proper formatting of outputs to prevent parsing errors and unexpect...
-
Use defensive SQL clauses
juspay/hyperswitch2⭐ 34028Always use defensive SQL clauses like `IF NOT EXISTS` and `IF EXISTS` in migration scripts to make them ide...
-
Minimize API test data
juspay/hyperswitch2⭐ 34028Keep API test configurations lean by including only the fields necessary for the specific test scenario. Av...
-
explicit database constraints
juspay/hyperswitch2⭐ 34028Be explicit about database constraints and avoid relying on database-level defaults. Always specify NOT NUL...
-
consistent configuration naming
juspay/hyperswitch2⭐ 34028Configuration variable names should follow consistent patterns and be descriptive enough to clearly convey ...
-
avoid hard-coded test data
juspay/hyperswitch2⭐ 34028Hard-coded test data creates maintenance burdens and unrealistic test scenarios. Instead of manually defini...
-
Target documentation to audience
helix-editor/helix2⭐ 39026Write documentation that matches both your audience's expertise level and the language's conventional forma...
-
omit redundant configuration
helix-editor/helix2⭐ 39026Remove configuration keys that explicitly set values identical to their defaults. This reduces visual clutt...
-
API documentation accuracy
helix-editor/helix2⭐ 39026Ensure API documentation accurately describes actual behavior and avoids subjective commentary that may bec...
-
Workflow permission boundaries
grafana/grafana2⭐ 68825Always define explicit and minimal permission boundaries in GitHub Actions workflows to adhere to the princ...
-
Use dynamic port allocation
grafana/grafana2⭐ 68825When writing tests that require network services (HTTP, gRPC, or custom protocols), use port 0 to let the o...
-
Stable test assertions
grafana/grafana2⭐ 68825Write tests that focus on behavior rather than implementation details to create more stable and maintainabl...
-
Sort with clarity
grafana/grafana2⭐ 68825Ensure sorting functions are named to accurately reflect their behavior and implement consistent sorting ap...
-
Opt-in configurable caching
grafana/grafana2⭐ 68825Implement caching mechanisms as opt-in features with explicit configuration options rather than as defaults...
-
Object parameters for readability
grafana/grafana2⭐ 68825When a function has 3 or more parameters, use object destructuring instead of positional arguments. This im...
-
Document translatable UI text
grafana/grafana2⭐ 68825All user-facing text in UI components should be properly documented for translation using the application's...
-
Defense in depth
grafana/grafana2⭐ 68825Always implement multiple layers of security controls, even when they might seem redundant. This strategy e...
-
Contextual structured logging
grafana/grafana2⭐ 68825Log messages should provide sufficient context to be meaningful and actionable while following structured l...
-
Check before calculating
grafana/grafana2⭐ 68825Implement preliminary validation checks before executing expensive operations to avoid unnecessary processi...
-
Balance flexibility with simplicity
grafana/grafana2⭐ 68825When designing component APIs, strive to find the optimal balance between providing flexible configuration ...
-
Assert with precision
grafana/grafana2⭐ 68825Tests should verify actual behavior rather than just successful execution. When writing assertions, favor p...
-
Validate object availability
block/goose2⭐ 19037Always verify that objects and their properties exist before accessing them to prevent null reference error...
-
validate IPC inputs
block/goose2⭐ 19037Always validate and sanitize inputs to IPC handlers to prevent unauthorized access to system resources. Imp...
-
Use self-documenting names
block/goose2⭐ 19037Choose variable, function, and constant names that clearly express their purpose and eliminate the need for...
-
Use established logging libraries
block/goose2⭐ 19037Avoid using print statements (println!, eprintln!) or custom logging implementations for application loggin...
-
Use configuration enums
block/goose2⭐ 19037Replace hardcoded string matching and magic values with proper configuration enums or flags. This improves ...
-
Sanitize untrusted input
block/goose2⭐ 19037Always sanitize or escape untrusted input before using it in security-sensitive contexts to prevent injecti...
-
Optimize algorithmic efficiency
block/goose2⭐ 19037Always consider the computational complexity of your algorithms and leverage efficient built-in methods whe...
-
leverage TypeScript nullability
block/goose2⭐ 19037When dealing with values that may be null or undefined, explicitly leverage TypeScript's nullable types to ...
-
Keep dependencies current
block/goose2⭐ 19037Always use the latest stable versions of dependencies in configuration files like Cargo.toml, and avoid dep...
-
Incremental CI development
block/goose2⭐ 19037Develop CI/CD workflows incrementally, starting with simpler versions and adding complexity gradually. This...
-
Extract duplicate constants
block/goose2⭐ 19037Eliminate code duplication by extracting repeated values and components into well-organized constants. This...
-
Document API contracts
block/goose2⭐ 19037Ensure all API interfaces have clearly documented contracts specifying expected request/response formats, d...
-
dependency version precision
block/goose2⭐ 19037Choose appropriate version constraints in package.json based on stability requirements and risk tolerance. ...
-
Database migration isolation
block/goose2⭐ 19037When performing database migrations or schema changes, use containerized environments to ensure isolation a...
-
containerize sensitive workflows
block/goose2⭐ 19037Use containerization to isolate operations that could access sensitive data, modify critical systems, or ex...
-
Conditional telemetry flushing
block/goose2⭐ 19037Avoid fixed delays for telemetry flushing. Instead, make flushing conditional on whether telemetry endpoint...
-
wrap errors properly
golang/go2⭐ 129599When creating error messages that include information from underlying errors, use fmt.Errorf with the %w ve...
-
Use conventional descriptive names
golang/go2⭐ 129599Variable names should follow established language conventions and clearly communicate their purpose and con...
-
maintain backward compatibility
golang/go2⭐ 129599When modifying existing APIs, preserve original parameter types and return signatures to avoid breaking cli...
-
go:build directive syntax
golang/go2⭐ 129599Ensure go:build directives follow correct syntax with no space between "//" and "go", and use proper logica...
-
Documentation quality standards
golang/go2⭐ 129599Ensure all documentation comments follow proper formatting conventions and are placed where developers will...
-
Use standard HTTP constants
gin-gonic/gin2⭐ 83022Always use the standard HTTP status constants from the `http` package instead of raw numeric values in your...
-
Select algorithms by complexity
gin-gonic/gin2⭐ 83022Choose appropriate algorithms based on computational complexity requirements and context. When implementing...
-
Preserve security configurations
gin-gonic/gin2⭐ 83022Always respect explicitly set security attributes and properly sanitize user inputs to prevent security vul...
-
Pin dependency versions
gin-gonic/gin2⭐ 83022Always specify exact versions of tools and dependencies in CI/CD workflows rather than using 'latest' or fl...
-
Minimize configuration complexity
gin-gonic/gin2⭐ 83022Keep configuration files clean and maintainable by regularly reviewing and removing unnecessary settings an...
-
Initialize before null-checking
gin-gonic/gin2⭐ 83022When handling potentially nil values, ensure proper initialization order to prevent race conditions and nul...
-
Document API behavior
gin-gonic/gin2⭐ 83022Thoroughly document how your API endpoints handle data binding and processing, especially non-obvious behav...
-
Declare .PHONY targets
gin-gonic/gin2⭐ 83022Always explicitly declare all Makefile targets that don't create files as `.PHONY`. This prevents conflicts...
-
Close resource handles properly
gin-gonic/gin2⭐ 83022Always close file resources and other system handles after use to prevent resource leaks. Resource leaks ca...
-
Prefer flat control flow
ghostty-org/ghostty2⭐ 32864Minimize code nesting by using Swift features like `guard` statements and early returns instead of deeply n...
-
Pipeline-friendly script design
ghostty-org/ghostty2⭐ 32864Design scripts to be easily integrated into build pipelines and CI/CD workflows by using standard I/O strea...
-
Generate dynamic configurations
ghostty-org/ghostty2⭐ 32864Always generate configuration files programmatically when they contain dynamic content that changes frequen...
-
Format for readability
ghostty-org/ghostty2⭐ 32864Documentation should be formatted to optimize readability and information retention. Apply these principles...
-
Use appropriate logging levels
google-gemini/gemini-cli2⭐ 65062Use console.debug() for debug information instead of console.log() to prevent cluttering user-facing output...
-
Prefer lightweight composable APIs
google-gemini/gemini-cli2⭐ 65062When designing APIs, favor lightweight, composable solutions that allow callers to maintain control over th...
-
optimize React hooks usage
google-gemini/gemini-cli2⭐ 65062Avoid useRef unless strictly necessary and ensure useEffect has proper dependencies to prevent unnecessary ...
-
minimize performance overhead
google-gemini/gemini-cli2⭐ 65062Reduce unnecessary overhead in performance-related code by creating reusable patterns and avoiding verbose ...
-
avoid non-null assertions
google-gemini/gemini-cli2⭐ 65062Avoid using the non-null assertion operator (`!`) and instead use union types or explicit null checks for b...
-
Validate security-critical inputs
fatedier/frp2⭐ 95938Always implement thorough validation for user-controllable inputs that could pose security risks. Particula...
-
Focus documentation content
fatedier/frp2⭐ 95938Maintain streamlined primary documentation (like README files) that focuses only on currently supported fun...
-
Document code decisions
fatedier/frp2⭐ 95938Always include clear documentation for important code decisions and metadata. This includes preserving copy...
-
Check context cancellation
fatedier/frp2⭐ 95938Always implement proper cancellation mechanisms in concurrent code to prevent goroutine leaks and enable ti...
-
Precise testing dependency versioning
laravel/framework2⭐ 33763When specifying testing library dependencies, always use explicit minimum patch versions rather than develo...
-
Mark sensitive parameters
laravel/framework2⭐ 33763Always use the `#[\SensitiveParameter]` attribute for parameters containing sensitive information such as p...
-
Use named constants
flutter/flutter2⭐ 172252Replace hardcoded string literals and magic values with named constants to improve code maintainability and...
-
Manage state dependencies properly
flutter/flutter2⭐ 172252Ensure components establish explicit dependencies when they need to react to external changes, and avoid st...
-
validate environment variables early
firecrawl/firecrawl2⭐ 54535Environment variables should be validated at startup or module initialization rather than at runtime usage....
-
preserve raw network data
firecrawl/firecrawl2⭐ 54535Always preserve raw network response data early in the processing pipeline before applying any transformati...
-
preserve null semantics
firecrawl/firecrawl2⭐ 54535When null or undefined values represent meaningful absence of data, preserve them rather than converting to...
-
optimize frequent operations
firecrawl/firecrawl2⭐ 54535Identify code paths that execute frequently and ensure they use performant, non-blocking solutions. Frequen...
-
Minimize database roundtrips
firecrawl/firecrawl2⭐ 54535Avoid making multiple database queries when a single query can retrieve the required data. Each database ro...
-
Avoid async race conditions
firecrawl/firecrawl2⭐ 54535Ensure proper async/await handling and consider concurrent execution patterns to prevent race conditions an...
-
API endpoint simplicity
firecrawl/firecrawl2⭐ 54535Design API endpoints with concise, direct naming that clearly communicates their purpose without unnecessar...
-
simplify logging integrations
gofiber/fiber2⭐ 37560When implementing custom logging integrations, prioritize simplicity and completeness over complex abstract...
-
minimize unsafe reference lifetime
gofiber/fiber2⭐ 37560When working with methods that return potentially unsafe references or data that could become invalid, pass...
-
justified nolint exceptions
gofiber/fiber2⭐ 37560When style linters cannot be applied universally across a codebase due to architectural constraints or legi...
-
Document error conditions clearly
gofiber/fiber2⭐ 37560Always provide clear documentation for error conditions, unsafe usage patterns, and failure scenarios in AP...
-
Configurable logging controls
gofiber/fiber2⭐ 37560Make logging behavior configurable rather than hardcoded, and avoid manipulating global state for logging p...
-
avoid `-count=1` flag
gofiber/fiber2⭐ 37560Avoid using the `-count=1` flag in Go test commands unless specifically required to disable test caching. R...
-
API design clarity
gofiber/fiber2⭐ 37560Maintain clear separation of concerns in API design by avoiding feature overlap and ensuring each method ha...
-
Verify types in tests
fastify/fastify2⭐ 34000Use explicit type assertions in TypeScript tests to verify that types behave as expected across various sce...
-
Use bot identity
fastify/fastify2⭐ 34000When configuring Git operations in GitHub Actions workflows, especially for automated commits, use the GitH...
-
Support flexible logging
fastify/fastify2⭐ 34000When designing logging interfaces, create flexible APIs that accommodate both standard and custom logging n...
-
Secure Fastify Code Implementation
fastify/fastify2⭐ 34000This review focuses on secure implementation patterns when using the Fastify web framework in TypeScript: p...
-
Proper IPv6 address formatting
fastify/fastify2⭐ 34000When constructing URLs with IP addresses, ensure IPv6 addresses are properly formatted according to RFC sta...
-
Ensure Proper Null Handling When Using Fastify Decorators
fastify/fastify2⭐ 34000When working with Fastify decorators, always perform explicit null checks before accessing potentially unde...
-
Consistent Fastify Package Naming and References
fastify/fastify2⭐ 34000When implementing code using the Fastify package in TypeScript, it is important to use consistent and accur...
-
Use universally understandable identifiers
fastapi/fastapi2⭐ 86871When naming variables, functions, routes, and other code elements, use clear, neutral terminology that will...
-
Use streaming generators
fastapi/fastapi2⭐ 86871When processing large files or datasets, implement generator functions that yield data incrementally rather...
-
Use appropriate documentation formats
fastapi/fastapi2⭐ 86871Choose the most suitable documentation format based on context to maximize readability and information valu...
-
Optimize IO with async
fastapi/fastapi2⭐ 86871FastAPI's performance advantage comes from its asynchronous foundation built on Starlette and Uvicorn, usin...
-
Environment-specific database configuration
fastapi/fastapi2⭐ 86871Configure database connections differently based on the environment. Use lightweight file-based databases l...
-
Consistent dependency versioning
fastapi/fastapi2⭐ 86871When updating dependency version constraints in requirements files, ensure consistency with versions pinned...
-
Clear informative errors
fastapi/fastapi2⭐ 86871Error messages should be clear, specific, and provide enough context to understand the issue without exposi...
-
Avoid blocking in async
fastapi/fastapi2⭐ 86871When working with asynchronous code, ensure that I/O operations (like file reads/writes) don't block the ev...
-
Modern TypeScript style
expressjs/express2⭐ 67300Use modern TypeScript syntax and conventions throughout the codebase. This includes: - Using `const` instea...
-
Method chaining for clarity
expressjs/express2⭐ 67300Design API methods that favor chaining over multiple parameters to improve readability and maintainability....
-
Maintain API types
expressjs/express2⭐ 67300Ensure API type definitions accurately reflect current implementations. When maintaining TypeScript definit...
-
Exclude sensitive configurations
expressjs/express2⭐ 67300Do not commit sensitive, time-limited, or environment-specific configuration files to version control. Inst...
-
Clear array operations
expressjs/express2⭐ 67300When working with arrays, prioritize clarity and explicitness over terse or clever constructs. For array me...
-
Accurate JSDoc documentation
expressjs/express2⭐ 67300Always ensure JSDoc comments accurately reflect the actual code implementation. Parameter types, optionalit...
-
minimize test maintenance
evanw/esbuild2⭐ 39161Avoid unnecessary test maintenance overhead by eliminating duplicate test coverage and implementing automat...
-
Follow configuration conventions
evanw/esbuild2⭐ 39161When working with configurations, maintain consistency by following established conventions and proper cate...
-
cross-platform API consistency
evanw/esbuild2⭐ 39161Design APIs to provide consistent behavior and user experience across different runtime environments and mo...
-
Scope configuration impact
electron/electron2⭐ 117644When implementing configuration settings, carefully consider and limit their scope to prevent unintended br...
-
Protocol-specific network handling
electron/electron2⭐ 117644When implementing custom network protocol behavior, ensure that modifications are properly scoped to only t...
-
extract reusable workflow components
electron/electron2⭐ 117644Avoid duplicating workflow steps across multiple CI/CD pipelines by extracting common functionality into re...
-
consistent platform identifiers
electron/electron2⭐ 117644When naming platform identifiers, choose one naming convention and use it consistently throughout the codeb...
-
avoid runtime credential resolution
electron/electron2⭐ 117644Security credentials and access control mechanisms should be pre-configured at deployment or configuration ...
-
Use current configuration patterns
elastic/elasticsearch2⭐ 73104Always use the current recommended configuration patterns for your project, avoiding deprecated approaches....
-
Specify explicit REST formats
elastic/elasticsearch2⭐ 73104Always specify explicit request formats in REST API tests rather than relying on default behaviors. This in...
-
Document security requirements explicitly
elastic/elasticsearch2⭐ 73104Always document security-related configurations, permissions, and behaviors explicitly and comprehensively....
-
Document performance tradeoffs
elastic/elasticsearch2⭐ 73104Always explicitly document the performance implications of API parameters, limit changes, and features that...
-
Complete API parameter documentation
elastic/elasticsearch2⭐ 73104API endpoints must include comprehensive documentation for all parameters. For each parameter, clearly spec...
-
Avoid flaky tests
elastic/elasticsearch2⭐ 73104Design tests to be deterministic and reliable across different environments. Tests that occasionally fail d...
-
use robust test selectors
dyad-sh/dyad2⭐ 16903E2E tests should use stable, reliable selectors and waiting strategies to prevent flaky test failures. Pref...
-
Use parameter objects
dyad-sh/dyad2⭐ 16903Design API methods to accept parameter objects instead of individual parameters or complex optional fields....
-
separate model-specific configuration
dyad-sh/dyad2⭐ 16903Avoid mixing model-specific features with provider-level configuration or hard-coding model-specific logic ...
-
Maintain naming consistency
dyad-sh/dyad2⭐ 16903Ensure naming follows consistent patterns within the codebase and adheres to official framework conventions...
-
Use specialized sensitive types
duckdb/duckdb2⭐ 32061When handling sensitive data like encryption keys, choose data types based on the data's lifecycle and secu...
-
secure sensitive data handling
duckdb/duckdb2⭐ 32061When handling sensitive data like encryption keys, passwords, or authentication tokens, avoid using standar...
-
Preserve API backward compatibility
duckdb/duckdb2⭐ 32061When modifying existing APIs, ensure that current usage patterns continue to work unchanged. This applies t...
-
prefer environment variables
duckdb/duckdb2⭐ 32061When configuring behavior that needs to work across different execution contexts (CI workflows, manual runs...
-
maintain formatting consistency
duckdb/duckdb2⭐ 32061Ensure consistent formatting patterns and styles throughout the codebase, both when writing new code and re...
-
maintain API backwards compatibility
duckdb/duckdb2⭐ 32061Never modify existing stable API versions in ways that could break backwards compatibility. When adding new...
-
ensure comprehensive test coverage
duckdb/duckdb2⭐ 32061Tests should validate all relevant code paths and actually exercise the functionality they claim to test. W...
-
avoid redundant computations
duckdb/duckdb2⭐ 32061Move loop-invariant conditions and computations outside of iteration blocks to improve performance and redu...
-
Use relative documentation links
stanfordnlp/dspy2⭐ 27813Always use relative links instead of absolute links in documentation files to enable proper broken link det...
-
synchronize configuration environments
stanfordnlp/dspy2⭐ 27813Ensure configuration values remain consistent between local development and CI/CD environments, and documen...
-
Dependency lock file management
stanfordnlp/dspy2⭐ 27813Always commit dependency lock files (poetry.lock, package-lock.json, etc.) to version control and maintain ...
-
AI signature consistency
stanfordnlp/dspy2⭐ 27813Ensure AI model signatures maintain consistency between field types and descriptions, and avoid redundant p...
-
Add comprehensive test coverage
stanfordnlp/dspy2⭐ 27813When introducing new functionality, always include corresponding test coverage that extends existing test i...
-
track migration state immediately
drizzle-team/drizzle-orm2⭐ 29461Ensure migration state is recorded in the database immediately after each migration file is successfully ap...
-
intuitive API method design
drizzle-team/drizzle-orm2⭐ 29461Design API methods with intuitive names and signatures that follow established conventions and provide good...
-
consistent naming patterns
drizzle-team/drizzle-orm2⭐ 29461Maintain consistent naming conventions across similar constructs in your codebase. This includes using cons...
-
avoid cosmetic formatting changes
drizzle-team/drizzle-orm2⭐ 29461Avoid including purely cosmetic formatting changes in pull requests that serve a functional purpose. Automa...
-
Organize by functionality
django/django2⭐ 84182Place code in files that match its functionality. When functionality applies to multiple components, use a ...
-
AI documentation targeting
django/django2⭐ 84182When writing technical documentation, consider AI systems as a direct audience that may read and act upon y...
-
Domain-appropriate data structures
wagoodman/dive2⭐ 51517Design data structures that accurately reflect the constraints and behavior of your problem domain. Choose ...
-
Self-documenting identifiers
discourse/discourse2⭐ 44898Choose names that are immediately understandable without requiring additional context, documentation lookup...
-
Prevent async race conditions
discourse/discourse2⭐ 44898When handling multiple concurrent async operations (like user input triggering API calls or messageBus upda...
-
prefer async/await patterns
discourse/discourse2⭐ 44898Convert promise chains to async/await syntax for better readability, error handling, and proper cleanup ope...
-
optimize data structure choices
discourse/discourse2⭐ 44898Choose data structures that optimize for your access patterns and computational complexity requirements. Wh...
-
MessageBus subscription practices
discourse/discourse2⭐ 44898When using MessageBus for network communication, follow these essential practices to ensure reliable messag...
-
Log errors for debugging
discourse/discourse2⭐ 44898Always log errors in catch blocks and use named functions to improve debugging and error traceability. Empt...
-
Limit plugin outlet APIs
discourse/discourse2⭐ 44898When creating plugin outlets or extension points, avoid exposing entire component instances, controllers, o...
-
Control event propagation
discourse/discourse2⭐ 44898Prevent unintended network requests and interface conflicts by properly controlling event propagation in in...
-
Consistent text formatting
discourse/discourse2⭐ 44898Ensure text formatting follows established guidelines and maintains consistency within the same context. Th...
-
avoid dynamic test generation
discourse/discourse2⭐ 44898Avoid using loops (forEach, for, etc.) to dynamically generate tests from arrays or objects, as this patter...
-
Validate before accessing
langgenius/dify2⭐ 114231Always validate preconditions before performing operations that could throw runtime errors. This includes c...
-
Separate AI instructions
langgenius/dify2⭐ 114231Always separate AI model instructions from user input to prevent prompt injection vulnerabilities and maint...
-
Responsible AI management
langgenius/dify2⭐ 114231Ensure AI models are managed responsibly throughout their lifecycle and have appropriate boundaries on thei...
-
prefer nullish coalescing operator
langgenius/dify2⭐ 114231Use the nullish coalescing operator (`??`) instead of logical OR (`||`) when you want to provide default va...
-
Offload heavy operations
langgenius/dify2⭐ 114231Move heavy operations, especially those involving large data processing or bulk deletions, from synchronous...
-
Manage side effects properly
langgenius/dify2⭐ 114231Avoid performing side effects directly in component render functions. Use useEffect for side effects like A...
-
Document for team readability
langgenius/dify2⭐ 114231Ensure code includes appropriate documentation to improve readability and help team members understand and ...
-
Document configuration choices
langgenius/dify2⭐ 114231Configuration scripts and files should clearly document non-obvious choices, especially numeric IDs, specia...
-
CI testing tool integration
langgenius/dify2⭐ 114231When integrating new testing or analysis tools into CI pipelines, use graceful failure patterns during init...
-
API payload structure
langgenius/dify2⭐ 114231Design API request and response payloads to match their specific purpose rather than forcing them to confor...
-
Platform-specific configuration separation
zen-browser/desktop2⭐ 34711Configuration options should be separated between common/shared settings and platform-specific settings to ...
-
event delegation patterns
zen-browser/desktop2⭐ 34711When handling events in web applications, especially those involving network-triggered UI updates or real-t...
-
consistent CSS spacing
zen-browser/desktop2⭐ 34711Ensure consistent spacing across UI components by using CSS custom properties for padding/margins and apply...
-
Verify algorithm correctness
denoland/deno2⭐ 103714Ensure algorithms produce expected results by validating data flow and checking that all execution paths re...
-
validate configuration schemas
denoland/deno2⭐ 103714Configuration schemas should be actively validated, well-documented, and kept up-to-date through automated ...
-
Use standard API interfaces
denoland/deno2⭐ 103714Always prefer established API interfaces and patterns over custom or alternative approaches. This ensures c...
-
remove unnecessary prefixes
denoland/deno2⭐ 103714Remove vendor prefixes from CSS properties that have achieved sufficient browser support across modern brow...
-
prevent prototype pollution
denoland/deno2⭐ 103714When implementing security measures around JavaScript's `__proto__` property, disable the setter to prevent...
-
prefer efficient built-ins
denoland/deno2⭐ 103714When multiple built-in methods can accomplish the same algorithmic task, prefer the single comprehensive me...
-
null checks before operations
denoland/deno2⭐ 103714Always check for null or undefined values before performing operations on objects, accessing properties, or...
-
Manage async operation lifecycle
denoland/deno2⭐ 103714When working with async operations, carefully manage execution context and resource references across await...
-
Extract complex inline logic
denoland/deno2⭐ 103714When functions contain complex inline logic or duplicated code, extract this logic into separate functions ...
-
Enhance error message clarity
denoland/deno2⭐ 103714Error messages should be both specific about what went wrong and provide contextual information to help dev...
-
comprehensive test verification
denoland/deno2⭐ 103714Write tests that comprehensively verify functionality by covering related scenarios and testing complete ou...
-
comprehensive test coverage
denoland/deno2⭐ 103714Ensure tests cover both happy path scenarios and edge cases, including error conditions and boundary behavi...
-
benchmark performance assumptions
denoland/deno2⭐ 103714Always validate performance assumptions with concrete benchmarks rather than making optimization decisions ...
-
avoid tooling workarounds
denoland/deno2⭐ 103714Avoid code patterns that require workarounds for tooling limitations or create maintenance burdens. This in...
-
avoid redundant observability data
denoland/deno2⭐ 103714When implementing observability features like tracing and monitoring, avoid exposing redundant information ...
-
Type-safe numerical algorithms
deeplearning4j/deeplearning4j2⭐ 14036When implementing numerical algorithms, always use appropriate data types to prevent overflow and preserve ...
-
Prevent memory leaks
deeplearning4j/deeplearning4j2⭐ 14036Always ensure proper memory management when using dynamic allocation. Memory leaks are a critical performan...
-
Preserve API compatibility
deeplearning4j/deeplearning4j2⭐ 14036When evolving APIs, prioritize backward compatibility to protect existing client code. Make new parameters ...
-
Optimize validation checks
deeplearning4j/deeplearning4j2⭐ 14036When implementing validation and requirement checks, balance thoroughness with performance considerations. ...
-
Optimize hardware acceleration
deeplearning4j/deeplearning4j2⭐ 14036AI systems should use the most performant hardware acceleration libraries and carefully manage hardware-spe...
-
Modular adaptive configurations
deeplearning4j/deeplearning4j2⭐ 14036Structure configuration scripts with modularity and adaptability in mind. Extract repeated parameters into ...
-
Maintain proper capitalization
deeplearning4j/deeplearning4j2⭐ 14036Always use correct and consistent capitalization for product names, class names, and method names throughou...
-
Ensure test determinism
deeplearning4j/deeplearning4j2⭐ 14036Create reliable and reproducible tests by explicitly controlling test inputs and verifying function behavio...
-
Document in-code decisions
deeplearning4j/deeplearning4j2⭐ 14036Always include explanations for implementation decisions, non-obvious constructs, and specialized functions...
-
Document AI implementation references
deeplearning4j/deeplearning4j2⭐ 14036When implementing AI algorithms or neural network operations, document the sources of specific implementati...
-
Use descriptive testing names
cypress-io/cypress2⭐ 48850Ensure all testing-related identifiers, scripts, and messages use clear, descriptive names rather than abbr...
-
Test version compatibility
cypress-io/cypress2⭐ 48850When testing across different versions of dependencies, proactively address version compatibility issues to...
-
Strengthen test assertions
cypress-io/cypress2⭐ 48850Write specific, regression-proof test assertions that validate exact expected values rather than allowing a...
-
standardize API patterns
cypress-io/cypress2⭐ 48850Establish consistent patterns for API design, particularly for request/response formats and parameter struc...
-
Safe null access patterns
cypress-io/cypress2⭐ 48850Always provide fallbacks when accessing properties or methods on values that could be undefined or null to ...
-
Prioritize naming clarity
cypress-io/cypress2⭐ 48850Choose names and aliases that clearly communicate their purpose and meaning rather than optimizing for brev...
-
Prioritize JSX readability
cypress-io/cypress2⭐ 48850Favor inline conditional rendering in JSX over extracting logic to variables before the return statement, a...
-
prioritize backward compatibility
cypress-io/cypress2⭐ 48850When evolving APIs, prioritize maintaining backward compatibility over enforcing strict design constraints....
-
Prefer standard terminology
cypress-io/cypress2⭐ 48850Use widely accepted industry-standard names and conventions rather than descriptive but non-standard altern...
-
optimize dynamic loading
cypress-io/cypress2⭐ 48850When using dynamic imports, implement timing controls and strategic naming to ensure reliable and efficient...
-
Network data encoding
cypress-io/cypress2⭐ 48850Ensure network-related data like URLs and IP addresses are properly encoded and typed to prevent validation...
-
Improve code expressiveness
cypress-io/cypress2⭐ 48850Write code that clearly communicates its intent through expressive method names and simplified control flow...
-
ensure async synchronization
cypress-io/cypress2⭐ 48850When dealing with async operations that depend on external systems (servers, backends, etc.), ensure proper...
-
Document non-obvious code
cypress-io/cypress2⭐ 48850Add explanatory comments when code logic is unclear, implements workarounds, or has special reasoning that ...
-
Choose appropriate type comparisons
cypress-io/cypress2⭐ 48850When implementing algorithms that compare or process different data types, carefully consider the level of ...
-
await promise-returning functions
cypress-io/cypress2⭐ 48850Always await functions that return promises to ensure proper asynchronous execution and avoid potential rac...
-
avoid redundant I/O operations
cypress-io/cypress2⭐ 48850Identify and eliminate repeated expensive operations, particularly file system access, by implementing cach...
-
Avoid brittle CSS patterns
cypress-io/cypress2⭐ 48850Write CSS that prioritizes maintainability and reduces the likelihood of conflicts or brittleness. This inc...
-
Functional code examples
crewaiinc/crewai2⭐ 33945Ensure all code examples in documentation are complete, accurate, and ready to run without modification. Si...
-
Fail securely by default
crewaiinc/crewai2⭐ 33945When designing systems that handle sensitive operations, always default to the most secure behavior rather ...
-
Consistent configuration declarations
crewaiinc/crewai2⭐ 33945Ensure configuration specifications (such as version requirements, environment settings, and tool declarati...
-
Review configuration constants regularly
home-assistant/core2⭐ 80450Configuration constants and mappings require regular maintenance to stay aligned with evolving platform cap...
-
Restrict administrative access
home-assistant/core2⭐ 80450Implement proper authorization controls for sensitive operations that can modify system configuration or cr...
-
Prefer safe DOM manipulations
vuejs/core2⭐ 50769When manipulating DOM content, prefer safer alternatives to innerHTML when possible to prevent Cross-Site S...
-
Optimize build scripts
vuejs/core2⭐ 50769Improve CI/CD pipeline efficiency by optimizing package.json scripts. Run compatible tasks in parallel usin...
-
Maintain inline documentation
home-assistant/core2⭐ 80450Ensure inline code comments are accurate, current, and provide meaningful explanations for complex or uncle...
-
comprehensive error handling
adonisjs/core2⭐ 18071Ensure error handling mechanisms are comprehensive and graceful rather than limited or forceful. Use persis...
-
API response transformation
home-assistant/core2⭐ 80450When integrating external APIs, implement a translation layer that transforms responses into a standardized...
-
Align configurations with usage
vuejs/core2⭐ 50769Configuration files should accurately reflect the actual requirements and characteristics of your codebase....
-
User-friendly configuration retrieval
continuedev/continue2⭐ 27819When retrieving configuration values like API keys or environment variables, include helpful error messages...
-
Use async/await pattern
continuedev/continue2⭐ 27819Prefer async/await syntax over promise chains or callback patterns when working with asynchronous operation...
-
Mutually exclusive promises
continuedev/continue2⭐ 27819Ensure that promises are either resolved or rejected, but never both. When handling promise resolution in c...
-
Logging levels hierarchy
continuedev/continue2⭐ 27819Use appropriate logging levels to prevent debug noise from leaking into production environments. Reserve co...
-
Layer documentation by complexity
continuedev/continue2⭐ 27819Structure documentation to be approachable for beginners while remaining comprehensive for all users. Keep ...
-
Avoid duplicated code
continuedev/continue2⭐ 27819Identify and extract shared functionality between classes into reusable components. Code duplication increa...
-
Use structured logging framework
docker/compose2⭐ 35858Prefer structured logging frameworks like logrus over direct fmt output functions for consistency, proper l...
-
Pin git dependencies
docker/compose2⭐ 35858When using git references for dependencies in configuration files like requirements.txt, always pin to spec...
-
optimize Docker layer caching
docker/compose2⭐ 35858Order Dockerfile instructions from least frequently changing to most frequently changing to maximize Docker...
-
Isolate test dependencies
docker/compose2⭐ 35858Keep test dependencies separate from production code dependencies to avoid polluting the main module. Use s...
-
evaluate dependency API compatibility
docker/compose2⭐ 35858Before adding or updating dependencies, thoroughly evaluate API compatibility and understand the implicatio...
-
Document complex code
docker/compose2⭐ 35858When code elements become complex—whether functions performing multiple operations or data structures with ...
-
Document CI/CD workflows clearly
docker/compose2⭐ 35858When documenting CI/CD processes, build pipelines, or deployment workflows, use clear and precise language ...
-
Avoid variable name conflicts
docker/compose2⭐ 35858Choose variable names that prevent conflicts with system variables, external tools, and variables in overla...
-
Avoid hardcoded configuration values
docker/compose2⭐ 35858Configuration values should be parameterized rather than hardcoded in scripts and tools. Hardcoded values m...
-
avoid external test dependencies
docker/compose2⭐ 35858Tests should not depend on external resources like real URLs, remote servers, or external APIs as these dep...
-
Avoid confusing names
docker/compose2⭐ 35858Choose clear, unambiguous names that don't shadow existing identifiers or create confusion about their purp...
-
Use optional chaining operators
comfyanonymous/ComfyUI2⭐ 83726Use optional chaining (`?.`) and nullish coalescing (`??`) operators instead of manual null checks to safel...
-
Structure documentation comprehensively
comfyanonymous/ComfyUI2⭐ 83726Documentation should provide complete, practical information while maintaining logical organization and inf...
-
Optimize tensor operation chains
comfyanonymous/ComfyUI2⭐ 83726When working with PyTorch tensors, look for opportunities to optimize operation chains for better performan...
-
leverage native configuration features
comfyanonymous/ComfyUI2⭐ 83726When configuring applications in containerized environments, prefer using the application's built-in config...
-
Container security best practices
comfyanonymous/ComfyUI2⭐ 83726Implement comprehensive security measures in containerized applications to prevent privilege escalation, in...
-
centralize configuration constants
comfyanonymous/ComfyUI2⭐ 83726Configuration values, constants, and default settings should be defined in a single location and referenced...
-
avoid hardcoded values
comfyanonymous/ComfyUI2⭐ 83726Replace hardcoded styling values and configuration constants with flexible alternatives to improve maintain...
-
AI hardware platform support
comfyanonymous/ComfyUI2⭐ 83726AI applications must properly handle different GPU platforms (NVIDIA CUDA, AMD ROCm, Iluvatar Corex, etc.) ...
-
Workspace version configuration
openai/codex2⭐ 31275Standardize version management across multi-crate Rust projects by using workspace versioning. This reduces...
-
Verify state before execution
openai/codex2⭐ 31275When scheduling asynchronous operations in concurrent environments, always verify the system state hasn't c...
-
Secure CI/CD pipelines
openai/codex2⭐ 31275Implement strict security controls in continuous integration and deployment workflows: 1. Pin external Git...
-
Provider-agnostic API design
openai/codex2⭐ 31275Design your API interfaces to be provider-agnostic rather than tightly coupled to specific service provider...
-
Provider-agnostic AI code
openai/codex2⭐ 31275Design AI integration code to be provider-agnostic, avoiding assumptions that all models will come from a s...
-
Proper package.json structure
openai/codex2⭐ 31275Maintain clean and properly structured package.json files by following these principles: 1. Categorize dep...
-
Pin external action dependencies
openai/codex2⭐ 31275Use full commit hashes instead of version tags when referencing third-party GitHub Actions in workflows to ...
-
Configure loggers consistently
salesforce/cloudsplaining2⭐ 2100Always configure module-level loggers with a consistent pattern across the codebase. Use `logging.getLogger...
-
Use null meaningfully
cline/cline2⭐ 48299Choose between null and undefined based on semantic intent rather than convenience. Use null when operation...
-
Remove production console logs
cline/cline2⭐ 48299Console logs should not appear in production code, especially debug statements that can expose sensitive in...
-
organize environment configurations
cline/cline2⭐ 48299Environment variables in CI/CD workflows should be organized consistently using structured `env` sections r...
-
optimize workflow maintainability
cline/cline2⭐ 48299Design CI/CD workflows for long-term maintainability by using consolidated commands and extracting reusable...
-
isolate mock configurations
cline/cline2⭐ 48299When using Vitest mocking, avoid multiple `vi.mock` calls for the same module within a single test file, as...
-
Handle async operations safely
cline/cline2⭐ 48299Always wrap asynchronous operations in try-catch blocks to prevent unhandled promise rejections and provide...
-
Document configuration assumptions
cline/cline2⭐ 48299When documenting configuration settings, environment setup, or system requirements, explicitly state assump...
-
Configure formatting tools consistently
cline/cline2⭐ 48299Properly configure development tools to maintain consistent code formatting across the entire codebase and ...
-
avoid unnecessary custom hooks
cline/cline2⭐ 48299Before creating custom hooks, evaluate whether existing solutions or simpler patterns can address the need....
-
Avoid premature memoization
cline/cline2⭐ 48299Don't automatically reach for useMemo and useCallback for every computation or function. These hooks add co...
-
Analyze async operation dependencies
cline/cline2⭐ 48299Before choosing between sequential awaits and parallel execution (Promise.all), carefully analyze whether o...
-
AI provider consistency
cline/cline2⭐ 48299Ensure consistent patterns and configurations across all AI model providers to maintain code maintainabilit...
-
AI capability documentation
cline/cline2⭐ 48299When documenting AI systems, models, or assistants, ensure technical terminology is precise and capabilitie...
-
Write focused, clear tests
ClickHouse/ClickHouse2⭐ 42425Tests should be simple, focused on a single concern, and easy to understand. When a test combines multiple ...
-
Recognize nullable type context
ClickHouse/ClickHouse2⭐ 42425Before adding nullable casts or special null handling logic, verify whether the type or context already pro...
-
preserve existing environment variables
ClickHouse/ClickHouse2⭐ 42425When modifying environment variables in code, always preserve existing values by appending or merging rathe...
-
Document implementation rationale
ClickHouse/ClickHouse2⭐ 42425When implementing networking or system-level functionality where multiple approaches exist, always document...
-
Document API parameters inline
ClickHouse/ClickHouse2⭐ 42425When designing APIs, prioritize clarity and self-documentation by adding inline comments for non-obvious pa...
-
consistent mutex protection
ClickHouse/ClickHouse2⭐ 42425Ensure consistent mutex usage across all access points to shared data structures and clearly document what ...
-
Comprehensive database testing
ClickHouse/ClickHouse2⭐ 42425Database tests should verify both query execution and optimization behavior through comprehensive scenario ...
-
avoid redundant cache lookups
ClickHouse/ClickHouse2⭐ 42425When implementing cache functionality, avoid performing the same cache lookup multiple times. Instead, stor...
-
verify downloaded file integrity
snyk/cli2⭐ 5178Always verify the integrity of downloaded files before using them, especially in security-sensitive applica...
-
Use file locks
snyk/cli2⭐ 5178When multiple processes or goroutines need to access shared file system resources concurrently, use file lo...
-
Use descriptive parameter names
snyk/cli2⭐ 5178Parameter names should clearly indicate their purpose and avoid ambiguity or conflicts with existing constr...
-
Use descriptive identifier names
snyk/cli2⭐ 5178Choose specific, descriptive names for variables, functions, types, and parameters that clearly indicate th...
-
separate build from runtime
snyk/cli2⭐ 5178Dependencies and build requirements should be installed during Docker image creation or environment setup, ...
-
maintain CI/CD boundaries
snyk/cli2⭐ 5178Ensure clear separation between different CI/CD concerns and maintain accurate documentation of automated p...
-
maintain build environment parity
snyk/cli2⭐ 5178Ensure that local development and CI/CD environments use identical build commands and dependency management...
-
Explain complex logic
snyk/cli2⭐ 5178Add explanatory comments for non-obvious code sections, complex business logic, and public methods to clari...
-
API interface design
snyk/cli2⭐ 5178Design interfaces that balance simplicity with extensibility. Consolidate related parameters into cohesive ...
-
Fail fast principle
anthropics/claude-code2⭐ 25432When writing security-sensitive shell scripts, use strict error handling to fail immediately on errors rath...
-
Maintain naming consistency
anthropics/claude-agent-sdk-python2⭐ 2158Ensure field names, method names, and identifiers are consistent across different contexts including cross-...
-
Verify automated documentation
chef/chef2⭐ 7860When using automated tools to generate documentation, always verify the output for accuracy and document an...
-
Structure CI/CD scripts
chef/chef2⭐ 7860Improve CI/CD shell scripts' readability and maintainability by using appropriate shell script patterns. Us...
-
Standardize bash error-handling
chef/chef2⭐ 7860Always use `set -eou pipefail` at the beginning of bash scripts to ensure consistent and robust error handl...
-
Log message quality
chef/chef2⭐ 7860Ensure all log messages are consistent in formatting and clear in purpose. Complete sentences in logs shoul...
-
Use correct encryption properties
bridgecrewio/checkov2⭐ 7668When configuring security features in Azure ARM templates, always use the correct property names as specifi...
-
Target core resources
bridgecrewio/checkov2⭐ 7668When implementing network security checks for serverless functions like AWS Lambda, ensure you target the c...
-
Secure API endpoints
bridgecrewio/checkov2⭐ 7667Always configure proper authorization for API endpoints to prevent unauthorized access to back-end resource...
-
Minimize workflow complexity
bridgecrewio/checkov2⭐ 7668Keep GitHub Actions workflows efficient and maintainable by eliminating redundant configurations and ensuri...
-
Lambda CORS protection
bridgecrewio/checkov2⭐ 7667When implementing network security checks for AWS Lambda functions, ensure that CORS (Cross-Origin Resource...
-
Implement pre-commit hooks
bridgecrewio/checkov2⭐ 7668Automate quality and security checks by implementing pre-commit hooks in your Git repositories to catch iss...
-
Ensure dependency compatibility
bridgecrewio/checkov2⭐ 7668When adding or updating dependencies in configuration files (Pipfile, requirements.txt), ensure compatibili...
-
Configure security scanners completely
bridgecrewio/checkov2⭐ 7668Security scanning tools must be fully configured to maximize detection capabilities. When implementing tool...
-
Azure encryption property names
bridgecrewio/checkov2⭐ 7667When configuring encryption settings for Azure resources in ARM templates, always use the correct property ...
-
Optimize AI interactions
ChatGPTBox-dev/chatGPTBox2⭐ 10660When working with AI models and LLMs, optimize both prompts and input data to improve model performance and...
-
Context-aware null checking
ChatGPTBox-dev/chatGPTBox2⭐ 10660Choose null checking patterns based on your function's purpose and intended behavior with empty values. For...
-
Use unstable_cache directly
calcom/cal.com2⭐ 37732When implementing server-side caching in Next.js applications, prefer using `unstable_cache` with direct re...
-
Specify stable dependency versions
calcom/cal.com2⭐ 37732Always use specific semantic versions or caret ranges for stable releases in package.json and other depende...
-
optimize component memoization
calcom/cal.com2⭐ 37732When implementing React.memo for performance optimization, ensure props are structured to enable effective ...
-
CI conditional job handling
calcom/cal.com2⭐ 37732When implementing CI workflows with path-based filtering, ensure that conditional jobs don't inadvertently ...
-
Centralize workflow scheduling
calcom/cal.com2⭐ 37732Avoid scattering workflow scheduling logic across multiple handlers. Instead, create dedicated service meth...
-
Validate workflow files
oven-sh/bun2⭐ 79093Ensure all CI/CD workflow configuration files are validated for accuracy and consistency. Small errors in w...
-
Validate network inputs
oven-sh/bun2⭐ 79093Network code must validate all inputs and handle error conditions properly to prevent security vulnerabilit...
-
Validate loop boundary conditions
oven-sh/bun2⭐ 79093When implementing iterative algorithms, ensure comprehensive handling of edge cases and boundary conditions...
-
Use branch prediction
oven-sh/bun2⭐ 79093Optimize performance-critical algorithms by using branch prediction hints to guide the CPU. Add `UNLIKELY` ...
-
Thread-safe state transitions
oven-sh/bun2⭐ 79093When modifying shared state in multithreaded code, implement proper checks and state transitions to prevent...
-
Path comparison precision
oven-sh/bun2⭐ 79093When implementing file path matching or exclusion algorithms, use precise comparison techniques that respec...
-
Optimize database interactions
oven-sh/bun2⭐ 79093When working with database operations, prioritize efficiency by avoiding redundant query executions. Instea...
-
Match API conventions
oven-sh/bun2⭐ 79093Ensure API implementations match established conventions and reference implementations to maintain compatib...
-
Judicious move semantics
oven-sh/bun2⭐ 79093Apply C++ move semantics and lambda modifiers only when necessary. The `mutable` keyword should only be use...
-
Initialize default values
oven-sh/bun2⭐ 79093Always initialize class attributes with default values to prevent AttributeError exceptions when accessing ...
-
Hide implementation details
oven-sh/bun2⭐ 79093When designing APIs, carefully consider which elements of your implementation become part of the public int...
-
Function invocation syntax
oven-sh/bun2⭐ 79093Use the appropriate invocation syntax for functions based on their intended usage. Regular functions should...
-
Follow standard API specifications
oven-sh/bun2⭐ 79093Ensure API implementations strictly adhere to published specifications, even when adding features or optimi...
-
Document configuration variations
oven-sh/bun2⭐ 79093When documenting or implementing configuration options, always include variations needed for different envi...
-
Cache repeated accesses
oven-sh/bun2⭐ 79093When accessing the same property or calling the same function multiple times, especially in loops or perfor...
-
validate connection timeouts
browser-use/browser-use2⭐ 69139Always validate network connection states and implement explicit timeout handling to prevent zombie connect...
-
preserve exception context
browser-use/browser-use2⭐ 69139When handling exceptions, always preserve the original error context to aid in debugging and error diagnosi...
-
organize tests by category
browser-use/browser-use2⭐ 69139Structure test suites into clear, logical categories and run them as separate CI jobs for better paralleliz...
-
Model initialization formatting
browser-use/browser-use2⭐ 69139Maintain consistent formatting when initializing AI models and agents. Use proper spacing around assignment...
-
Maintain configuration consistency
browser-use/browser-use2⭐ 69139When modifying configuration settings, especially environment variables, ensure changes are consistent with...
-
Document configuration decisions
browser-use/browser-use2⭐ 69139Configuration files should be self-explanatory and maintainable by including explicit version constraints a...
-
Configuration documentation completeness
browser-use/browser-use2⭐ 69139Configuration documentation should include all necessary constraints and limitations while avoiding redunda...
-
Avoid logging sensitive content
browser-use/browser-use2⭐ 69139Be cautious about what data gets included in log messages to prevent security risks and performance issues....
-
Avoid hardcoded API assumptions
browser-use/browser-use2⭐ 69139API interfaces should not contain hardcoded implementation details or assume specific underlying technologi...
-
Resolve naming conflicts clearly
Homebrew/brew2⭐ 44168When naming components, packages, or files that conflict with existing names in your system or related ecos...
-
Prefer flags over conditionals
Homebrew/brew2⭐ 44168When implementing environment-specific or version-dependent behavior, use feature flags or configuration va...
-
Pin GitHub actions
Homebrew/brew2⭐ 44168Always pin GitHub Actions to specific commit hashes rather than version tags (like @v4). Using version tags...
-
Document configuration decisions
Homebrew/brew2⭐ 44168When making configuration changes, especially those that deviate from standard practices or involve depreca...
-
Decouple CI from code
Homebrew/brew2⭐ 44168Separate CI configuration from code that serves other purposes. When variables or settings affect both user...
-
Use appropriate comment syntax
boto/boto32⭐ 9417Choose the correct comment syntax based on the file type and processing system to ensure documentation serv...
-
Keep CI configurations updated
boto/boto32⭐ 9417Regularly review and update CI configuration files to remove obsolete settings and use appropriate version ...
-
Function-focused code organization
boto/boto32⭐ 9417Files should contain only code related to their named purpose, with proper organization and formatting. Whe...
-
Follow flake8 style guidelines
boto/boto32⭐ 9417Adhere to the project's established flake8 style guidelines as defined in setup.cfg. This includes: 1. Mai...
-
Avoid identifier name stuttering
boto/boto32⭐ 9417Do not repeat the resource name in identifier names. This form of stuttering makes code less readable and i...
-
Optimize database queries
better-auth/better-auth2⭐ 19651Avoid inefficient database query patterns by using batch operations and appropriate query types. Instead of...
-
Intentional configuration management
better-auth/better-auth2⭐ 19651Configuration choices should be intentional, balancing production requirements with developer experience wh...
-
Improve documentation clarity
better-auth/better-auth2⭐ 19651Write clear, accessible, and consistent documentation by using descriptive link text and providing complete...
-
Document configuration requirements
better-auth/better-auth2⭐ 19651Ensure that configuration requirements, dependencies, and options are clearly documented and communicated t...
-
API endpoint correctness
better-auth/better-auth2⭐ 19651API endpoints must behave according to their intended design, properly handling special values and executin...
-
Write specific test assertions
bazelbuild/bazel2⭐ 24489Make test assertions specific and verifiable rather than relying on generic metrics or counts. Use explicit...
-
Organize code for readability
bazelbuild/bazel2⭐ 24489Structure code to minimize complexity and improve readability through logical organization. This includes u...
-
Document network interface purposes
bazelbuild/bazel2⭐ 24489When implementing multiple network-related interfaces or classes that handle similar operations (like downl...
-
Document algorithmic reasoning
bazelbuild/bazel2⭐ 24489When implementing algorithms that involve data transformations, platform-specific behavior, or non-obvious ...
-
comprehensive edge case testing
bazelbuild/bazel2⭐ 24489Write comprehensive tests that cover edge cases and platform-specific scenarios to uncover underlying imple...
-
avoid brittle algorithms
bazelbuild/bazel2⭐ 24489Replace fragile algorithmic approaches with robust, well-tested alternatives. Brittle algorithms that rely ...
-
Automate sensitive CI artifacts
bazelbuild/bazel2⭐ 24489Large files and security-sensitive artifacts should be automatically generated in CI/CD pipelines rather th...
-
Use higher-level telemetry
Azure/azure-sdk-for-net2⭐ 5809When implementing observability for Azure services, prefer higher-level telemetry packages and configuratio...
-
Preserve protocol data integrity
Azure/azure-sdk-for-net2⭐ 5809When working with network protocols (like AMQP, NFS, or SMB), maintain the integrity of the original protoc...
-
Match CI commands locally
Azure/azure-sdk-for-net2⭐ 5809Always use the same build and test commands locally that are used in your CI pipeline to ensure consistency...
-
Handle external process errors
Azure/azure-sdk-for-net2⭐ 5809When calling external processes (like dotnet, msbuild, etc.), always implement proper error handling and ou...
-
Eliminate repeated code
Azure/azure-sdk-for-net2⭐ 5809Reduce code duplication by extracting repeated patterns into variables, loops, or helper functions. When yo...
-
Document non-obvious code
Azure/azure-sdk-for-net2⭐ 5809Add clarifying comments to code elements whose purpose or behavior may not be immediately apparent to other...
-
Document maintenance decisions
Azure/azure-sdk-for-net2⭐ 5809Add clear documentation for any decisions that affect future code maintenance. This includes: 1. Providing...
-
Document AI changes thoroughly
Azure/azure-sdk-for-net2⭐ 5809When updating AI libraries and SDKs, ensure all changes are thoroughly documented in changelogs with clear ...
-
Complete pipeline configurations
Azure/azure-sdk-for-net2⭐ 5809Ensure all CI/CD configuration files have their required fields properly populated with specific values rat...
-
Approve AI dependencies conditionally
Azure/azure-sdk-for-net2⭐ 5809All AI-related dependencies (Microsoft.Extensions.AI.*, etc.) require explicit approval before inclusion an...
-
Address not mask
Azure/azure-sdk-for-net2⭐ 5809Always address the root cause of CI/CD pipeline issues rather than masking them with quick fixes. This appl...
-
Use Appropriate Concurrency Patterns with Axum
tokio-rs/axum2⭐ 22100When building asynchronous Axum applications that share mutable state, it's important to select the right c...
-
Implement Distributed Tracing in Axum Applications
tokio-rs/axum2⭐ 22100As an Axum code reviewer, I recommend implementing proper distributed tracing in your Axum-based web applic...
-
User-friendly error messages
axios/axios2⭐ 107000Error messages should be concise and clearly communicate what went wrong without unnecessary verbosity. Whe...
-
Flexible configuration design
axios/axios2⭐ 107000Design configuration interfaces to be flexible and extensible rather than overly specific. When creating co...
-
Consistent semicolon usage
axios/axios2⭐ 107000Always terminate statements with explicit semicolons to maintain consistency with the existing codebase sty...
-
Consistent Axios Usage Patterns
axios/axios2⭐ 107000Maintain consistent usage of the Axios library throughout your TypeScript codebase. Pay special attention t...
-
Standardize API promise patterns
aws/aws-sdk-js2⭐ 7628When adding promise support to API methods, implement a consistent pattern that handles both callback-style...
-
Semantic type organization
aws/aws-sdk-js2⭐ 7628Organize types and interfaces in intuitive namespace hierarchies and use specific types instead of generic ...
-
Organize type declarations
aws/aws-sdk-js2⭐ 7628Structure TypeScript declarations to improve maintainability and developer experience. Organize related typ...
-
Example documentation standards
aws/aws-sdk-js2⭐ 7628Organize API documentation examples for maximum clarity and usefulness. Place hand-written examples before ...
-
Document sdk version requirements
aws/aws-sdk-js2⭐ 7628Always explicitly document AWS SDK version requirements in your project, and include configuration instruct...
-
Complete configuration type definitions
aws/aws-sdk-js2⭐ 7628Ensure configuration type definitions are complete and consistent between global and service-specific setti...
-
Accurate type signatures
aws/aws-sdk-js2⭐ 7628When defining API interfaces in TypeScript, ensure that method signatures accurately reflect the actual beh...
-
Verify URL security and validity
avelino/awesome-go2⭐ 151435Always ensure external URLs use HTTPS when available and verify that links resolve correctly before includi...
-
Verify markdown sanitization
avelino/awesome-go2⭐ 151435When processing markdown content, always verify what sanitization your chosen markdown library provides to ...
-
Follow Go style guidelines
avelino/awesome-go2⭐ 151435Code should adhere to the recommended Go style guidelines as outlined in the official Go Code Review Commen...
-
exported functions documentation
avelino/awesome-go2⭐ 151435All exported functions, types, and methods must include Go-style documentation comments that clearly explai...
-
Environment variable defaults
avelino/awesome-go2⭐ 151435Configuration values should be externalized to environment variables with sensible defaults to avoid hard-c...
-
Categorize by primary purpose
avelino/awesome-go2⭐ 151435When organizing configuration tools, environment management utilities, and settings-related projects, class...
-
validate conceptual API types
argoproj/argo-cd2⭐ 20149When defining API types, enums, or interfaces, ensure they represent accurate conceptual distinctions withi...
-
Use clear, descriptive names
argoproj/argo-cd2⭐ 20149Choose names that accurately describe their purpose and avoid unnecessary verbosity. Field names should sem...
-
structured condition evaluation
argoproj/argo-cd2⭐ 20149When implementing health checks, use comprehensive condition evaluation patterns instead of simple field co...
-
standardize commit tracing metadata
argoproj/argo-cd2⭐ 20149When CI/CD pipelines make automated commits (such as image bumps or manifest updates), use standardized git...
-
simplify nested conditionals
argoproj/argo-cd2⭐ 20149Combine multiple nested if statements using logical operators (and/or) to improve code readability and redu...
-
Remove unnecessary elements
argoproj/argo-cd2⭐ 20149Eliminate superfluous syntax and words that don't add value to improve code readability and maintain consis...
-
Prevent silent failures
argoproj/argo-cd2⭐ 20149Ensure that user actions and validations provide clear feedback rather than failing silently. When operatio...
-
prefer modern React patterns
argoproj/argo-cd2⭐ 20149Favor modern React patterns over legacy approaches to improve code maintainability and prepare for future R...
-
Organize CSS systematically
argoproj/argo-cd2⭐ 20149When working with CSS/SCSS, prioritize organization and avoid duplication by following these principles: 1...
-
null-check before method calls
argoproj/argo-cd2⭐ 20149Always verify that properties are not null or undefined before calling methods on them to prevent runtime e...
-
Follow established naming patterns
argoproj/argo-cd2⭐ 20149When introducing new identifiers (variables, methods, flags, metrics, etc.), examine existing code to ident...
-
Environment variable validation
argoproj/argo-cd2⭐ 20149Scripts that depend on environment variables should validate their presence and values early, providing cle...
-
Document observability prerequisites
argoproj/argo-cd2⭐ 20149When documenting observability features such as metrics, debugging capabilities, or monitoring tools, alway...
-
Document configuration risks comprehensively
argoproj/argo-cd2⭐ 20149When documenting configuration options, provide comprehensive information including current default values,...
-
Configuration UI consistency
argoproj/argo-cd2⭐ 20149Ensure that configuration user interfaces accurately reflect the underlying configuration behavior and data...
-
API parameter extensibility
argoproj/argo-cd2⭐ 20149Design APIs to support multiple parameters from the beginning rather than limiting them to single parameter...
-
Validate documentation links
appwrite/appwrite2⭐ 51959Always verify that URLs in documentation resolve correctly (return HTTP 200) before merging changes. Broken...
-
Prevent API documentation duplication
appwrite/appwrite2⭐ 51959When maintaining API specification files (like OpenAPI or Swagger), ensure consistency and avoid duplicatio...
-
Match defaults to types
appwrite/appwrite2⭐ 51959When specifying default values in schemas or configurations, ensure they match the declared type to prevent...
-
Flexible network handling
appwrite/appwrite2⭐ 51959When working with network connections and HTTP requests, implement flexible configuration patterns and robu...
-
Context-appropriate API authentication
appwrite/appwrite2⭐ 51959Always use the authentication method appropriate for your API client's execution context. Server-side SDKs ...
-
Consistent language in naming
appwrite/appwrite2⭐ 51959Use a single language (preferably English) consistently throughout your codebase for all identifiers includ...
-
Consistent database parameters
appwrite/appwrite2⭐ 51959Maintain consistency and clarity in database-related parameters and configuration variables. Follow these p...
-
Test network performance
ant-design/ant-design2⭐ 95882Always validate network performance and connectivity before suggesting alternative endpoints or making rout...
-
Pin CI dependencies securely
ant-design/ant-design2⭐ 95882Always pin CI/CD dependencies (GitHub Actions, external tools) to specific commit hashes or exact versions ...
-
Enforce CI workflow gates
ant-design/ant-design2⭐ 95882Establish and enforce proper CI/CD workflow gates to maintain code quality and release safety. This include...
-
consistent dependency formatting
ant-design/ant-design2⭐ 95882Maintain consistent formatting and organization when managing dependencies in package.json files. Use semve...
-
Use design system colors
angular/angular2⭐ 98611Always use design system color variables instead of hardcoded color values in stylesheets. This ensures con...
-
Pin GitHub Actions SHA
angular/angular2⭐ 98611GitHub Actions should be pinned to specific SHA commits rather than mutable tag references to ensure securi...
-
Optimize configuration specificity
angular/angular2⭐ 98611Ensure configuration files use precise patterns and avoid redundant dependencies. Configuration specificati...
-
Guard unsafe API calls
angular/angular2⭐ 98611Always check the availability or state of data before accessing potentially unsafe API methods that can thr...
-
Consider accessibility in markup
angular/angular2⭐ 98611When writing HTML markup, consider the accessibility implications of your formatting and structural choices...
-
Centralize configuration management
angular/angular2⭐ 98611Extract configuration state, feature flags, and version-dependent settings into dedicated services rather t...
-
User-friendly network descriptions
alacritty/alacritty2⭐ 59675When documenting network-related features like URL handling, hyperlinks, or web protocols, prioritize user-...
-
unsafe code practices
alacritty/alacritty2⭐ 59675Ensure proper use and documentation of unsafe code to prevent security vulnerabilities. The `unsafe` keywor...
-
synchronize platform configurations
alacritty/alacritty2⭐ 59675When making configuration changes that affect multiple platform-specific files, ensure all related configur...
-
Keep documentation together
alacritty/alacritty2⭐ 59675Documentation should keep related information physically close together rather than separating it across di...
-
centralize workspace dependencies
alacritty/alacritty2⭐ 59675Define shared dependencies at the workspace level in the root Cargo.toml to ensure version consistency and ...
-
Assess security trade-offs
alacritty/alacritty2⭐ 59675When introducing dependencies or features that have security implications, explicitly evaluate whether the ...
-
Validate configuration source changes
apache/airflow2⭐ 40858When switching between different configuration sources (like APIs or configuration values), ensure data str...
-
Use proper access patterns
apache/airflow2⭐ 40858Access configurations through documented abstraction layers rather than bypassing them with direct database...
-
Use guards over assertions
apache/airflow2⭐ 40858Prefer explicit type guards and null checks over TypeScript's type assertions (`as`) when handling potentia...
-
Quote shell variables
apache/airflow2⭐ 40858Always quote shell script variable expansions using double quotes to prevent word splitting issues and ensu...
-
Optimize CI configurations
apache/airflow2⭐ 40858When designing CI/CD workflows, prioritize both resource efficiency and clear documentation. Incorporate dy...
-
Natural language translations
apache/airflow2⭐ 40858When providing translations for user interface elements and documentation, prioritize natural and idiomatic...
-
Thread-safe message dispatching
Aider-AI/aider2⭐ 35856When implementing communication between multiple threads, ensure that messages are correctly routed to thei...
-
Isolate test environments
Aider-AI/aider2⭐ 35856Tests should be isolated from the production environment to prevent side effects and ensure reproducibility...
-
Compatible null annotations
Aider-AI/aider2⭐ 35856When annotating optional or nullable types in Python, ensure compatibility across all supported Python vers...
-
Versioning for migrations
vercel/ai2⭐ 15590Use appropriate version bumps to signal migration requirements and maintain clear upgrade paths. Flag break...
-
Optimize CI type checking
vercel/ai2⭐ 15590Configure separate TypeScript type-checking strategies for CI environments and local development. CI pipeli...
-
Format for rendering compatibility
vercel/ai2⭐ 15590Documentation should be formatted appropriately for its intended rendering context and ensure discoverabili...
-
Flexible API inputs
vercel/ai2⭐ 15590Design APIs to accept flexible input formats and schema structures, ensuring a better developer experience ...
-
Consistent camelCase naming
vercel/ai2⭐ 15590Use camelCase consistently for all property names, method names, and configuration options, even when inter...
-
Consistent AI interfaces
vercel/ai2⭐ 15590Maintain consistent naming patterns and parameter structures across AI provider implementations. This makes...
-
Validate environment bindings
cloudflare/agents2⭐ 2312Always validate that environment bindings exist and are of the expected type before using them, and ensure ...
-
validate connection protocols
cloudflare/agents2⭐ 2312Always validate network connection types, required parameters, and protocol-specific headers before process...
-
Test security boundaries
cloudflare/agents2⭐ 2312Security mechanisms should be tested for both success and failure scenarios to ensure they properly enforce...
-
Warn against sudo
zed-industries/zed1⭐ 62119Applications that may need elevated privileges should explicitly warn against running the entire applicatio...
-
avoid eval() function
facebook/yoga1⭐ 18255The eval() function executes arbitrary JavaScript code from strings, creating significant security vulnerab...
-
Privacy documentation clarity
cloudflare/workers-sdk1⭐ 3379When documenting data collection practices, telemetry, or analytics features, explicitly enumerate what sen...
-
prefer standard crypto functions
cloudflare/workers-sdk1⭐ 3379Use Node.js built-in crypto module functions instead of third-party cryptographic libraries when possible. ...
-
audit third-party dependencies
cloudflare/workers-sdk1⭐ 3379Before using third-party actions, libraries, or dependencies that require access to sensitive data (tokens,...
-
Configure secret scanning exceptions
cloudflare/workerd1⭐ 6989When embedding test certificates or cryptographic keys in code for testing purposes, configure secret scann...
-
Update security patches regularly
microsoft/vscode1⭐ 174887Always keep dependencies, runtime environments, and libraries updated with the latest security patches to m...
-
Shell-specific input escaping
microsoft/vscode1⭐ 174887When processing user input that will be used in shell commands, implement shell-specific escaping mechanism...
-
Document security implications
volcano-sh/volcano1⭐ 4899When writing documentation that involves handling sensitive data or security-related operations, always inc...
-
avoid unnecessary privilege tools
volcano-sh/volcano1⭐ 4899Do not install privilege escalation tools like sudo, su, or doas in containers unless they are explicitly r...
-
Verify dependency integrity
vitessio/vitess1⭐ 19815Always verify the integrity of external dependencies, especially those downloaded from non-official or pers...
-
Permission hierarchy awareness
vitejs/vite1⭐ 74031When implementing permission checks, understand the hierarchical nature of permissions and avoid redundant ...
-
Escape HTML content properly
vitejs/vite1⭐ 74031Always use specialized HTML escaping functions when outputting dynamic content to prevent Cross-Site Script...
-
explicit cryptographic parameters
vlang/v1⭐ 36582Always explicitly specify security-critical parameters in cryptographic operations rather than relying on d...
-
Document cryptographic requirements
vlang/v1⭐ 36582Security-critical functions, especially those involving cryptographic operations, must include clear and ac...
-
Mask sensitive tokens
astral-sh/uv1⭐ 60322Always mask sensitive tokens, credentials, and secrets in CI/CD workflows to prevent accidental exposure in...
-
Document credential formats
Unstructured-IO/unstructured1⭐ 12117When documenting security-sensitive parameters such as private keys, certificates, API tokens, or other aut...
-
validate input constraints
unionlabs/union1⭐ 74800Always validate user inputs against expected formats, constraints, and business rules before processing the...
-
Validate input before submission
unionlabs/union1⭐ 74800Always validate user input before enabling form submission to prevent processing of invalid or malicious da...
-
Add interactive element roles
shadcn-ui/ui1⭐ 90568When adding event handlers like `onClick` to non-interactive elements such as `div`, always include appropr...
-
Accessible security indicators
shadcn-ui/ui1⭐ 90568Ensure all security-related UI elements such as warnings, error messages, and destructive action buttons me...
-
Precise documentation links
vercel/turborepo1⭐ 28115When creating error messages related to security, permissions, or access controls, always provide specific ...
-
validate file paths
traefik/traefik1⭐ 55772Always validate and sanitize file paths when processing external input to prevent directory traversal attac...
-
Avoid unsafe code
huggingface/tokenizers1⭐ 9868Prioritize memory safety and security over performance optimizations by avoiding unsafe code blocks, especi...
-
Sanitize command inputs
hashicorp/terraform1⭐ 45532When constructing commands that will be executed, always sanitize input values to prevent command injection...
-
Least privilege for tokens
hashicorp/terraform1⭐ 45532Always apply the principle of least privilege when configuring access tokens for CI/CD workflows and other ...
-
Unicode homoglyph validation
microsoft/terminal1⭐ 99242Validate Unicode characters and detect potential homoglyph attacks where visually similar characters from d...
-
Maintain package verification
tensorflow/tensorflow1⭐ 190625Always keep signature verification enabled in package managers, even in development environments, Docker co...
-
Minimize credential data exposure
temporalio/temporal1⭐ 14953When handling security credentials (particularly TLS certificates) in data structures intended for transmis...
-
Minimize authentication complexity
gravitational/teleport1⭐ 19109Avoid implementing redundant authentication steps when secure, direct methods are already available. Multip...
-
defer authentication prompts
gravitational/teleport1⭐ 19109Defer mounting components that trigger authentication prompts (MFA, per-session authentication) until they ...
-
Validate security-sensitive inputs
spring-projects/spring-framework1⭐ 58382Always use appropriate validation mechanisms for security-sensitive inputs to prevent vulnerabilities. When...
-
Inherit organization security policies
spring-projects/spring-boot1⭐ 77637Before implementing custom security documentation or procedures, check if your organization already provide...
-
Use secure credential storage
SigNoz/signoz1⭐ 23369Avoid storing sensitive credentials like usernames and passwords in environment variables. Instead, use ded...
-
validate external system inputs
servo/servo1⭐ 32962When integrating with external systems that receive repository or organizational information, always implem...
-
maintain IAM role isolation
serverless/serverless1⭐ 46810Each resource should use the IAM role assigned to its associated function rather than sharing roles across ...
-
Secure dependency constraints
getsentry/sentry-php1⭐ 1873When specifying dependency version constraints, always include lower version bounds that exclude versions w...
-
Comprehensive authentication notifications
getsentry/sentry1⭐ 41297Authentication notifications must include specific context about the triggering action, clear instructions ...
-
configurable security controls
strands-agents/sdk-python1⭐ 4044Design security mechanisms with configurable behavior to handle different threat scenarios and use cases. A...
-
Constant-time cryptographic validation
dotnet/runtime1⭐ 16578Always use constant-time comparison methods when validating cryptographic values to prevent timing side-cha...
-
Use explicit permission notations
astral-sh/ruff1⭐ 40619When setting file permissions through system calls like `chmod`, always use explicit octal notation (with t...
-
validate client inputs
TanStack/router1⭐ 11590Always validate and sanitize client-provided data on the server side before processing. Client-side data, i...
-
Serialize dynamic code inputs
TanStack/router1⭐ 11590Always serialize or sanitize user-controlled data before embedding it in dynamically generated code to prev...
-
Escape XML content securely
RooCodeInc/Roo-Code1⭐ 17288Always use proper XML entity escaping instead of CDATA blocks when embedding XML-like content within XML do...
-
API authorization validation
smallcloudai/refact1⭐ 3114All API endpoints must implement proper authorization checks before processing requests, especially when au...
-
minimize public API exposure
facebook/react-native1⭐ 123178Keep internal implementation details private to reduce security attack surface. Public properties in header...
-
Prefer modern security
quarkusio/quarkus1⭐ 14667When implementing security features (such as artifact signing), use current best practices and prefer pure-...
-
Test authentication dependencies
prowler-cloud/prowler1⭐ 11834When updating authentication-related dependencies or adding new authentication capabilities (like SAML, OAu...
-
Precise CSP configuration
prowler-cloud/prowler1⭐ 11834When integrating third-party services into your web application, carefully configure Content Security Polic...
-
Fix dependency vulnerabilities
prowler-cloud/prowler1⭐ 11834Security vulnerabilities in dependencies must be addressed immediately rather than bypassed with flags like...
-
Avoid localStorage for credentials
prowler-cloud/prowler1⭐ 11834Do not store user profiles, authentication tokens, or other sensitive user information in client-side stora...
-
HTTP security headers
prometheus/prometheus1⭐ 59616Ensure that HTTP security headers are properly implemented and documented to prevent web vulnerabilities su...
-
Force re-sign Darwin binaries
prometheus/prometheus1⭐ 59616When building binaries for macOS (Darwin), always force re-sign them to prevent compatibility issues caused...
-
explicit authentication logic
prometheus/prometheus1⭐ 59616Make authentication and security-related boolean conditions explicit and direct rather than using intermedi...
-
avoid GitHub template injection
prometheus/prometheus1⭐ 59616Avoid using GitHub workflow template expressions `${{ }}` directly in shell commands within `run:` steps, a...
-
vet third-party actions
prisma/prisma1⭐ 42967Before using third-party GitHub Actions or similar external dependencies, thoroughly review their security ...
-
Verify HTML escaping
PostHog/posthog1⭐ 28460Always verify that user-controlled content in templates is properly HTML-escaped to prevent XSS attacks. Do...
-
Use proper authorization attributes
PostHog/posthog1⭐ 28460Avoid using Django framework attributes like `is_staff` and `is_impersonated` for application role checking...
-
Use allowlists over blocklists
PostHog/posthog1⭐ 28460When filtering data for security purposes, prefer allowlists (explicitly defining what is permitted) over b...
-
Redact sensitive credentials
pola-rs/polars1⭐ 34296When implementing authentication or handling credentials, always redact sensitive information (keys, tokens...
-
Secure encryption key backups
opentofu/opentofu1⭐ 25901Always implement proper encryption key management procedures, including secure backups of encryption keys b...
-
Preserve sensitive data marks
opentofu/opentofu1⭐ 25901Carefully handle data marked as sensitive throughout the codebase to maintain security properties. Ensure t...
-
Validate CI/CD timing checks
nuxt/nuxt1⭐ 57769When implementing timing-based security checks in CI/CD workflows, ensure that timestamp comparisons use ta...
-
Enforce permission-based UI controls
novuhq/novu1⭐ 37700Always implement proper authorization checks in UI components that expose sensitive functionality. Wrap but...
-
Scope security settings
nodejs/node1⭐ 112178Avoid modifying global security state in favor of connection-specific or context-bound security settings. G...
-
Document security attributes
vercel/next.js1⭐ 133000When handling security-related attributes (like nonces, integrity hashes, or CSP directives), always docume...
-
Decode before validation
vercel/next.js1⭐ 133000Always decode URL paths before performing security validations to prevent bypass attacks using URL encoding...
-
Secure proxy endpoints
ChatGPTNextWeb/NextChat1⭐ 85721Proxy endpoints that forward requests to external services can be exploited by malicious actors if left uns...
-
Use secure hash algorithms
nestjs/nest1⭐ 71767Always use strong, modern cryptographic hash algorithms for security-sensitive operations. Avoid deprecated...
-
Secure hash algorithms
nestjs/nest1⭐ 71766Always use cryptographically secure hash algorithms for sensitive operations instead of weak or broken ones...
-
Proactive dependency security
nestjs/nest1⭐ 71767Always maintain dependencies at their latest secure versions, even when automated vulnerability scanning to...
-
Comprehensive dependency security checks
nestjs/nest1⭐ 71766Regularly check dependencies for security vulnerabilities using multiple sources, not just npm audit. As sh...
-
Security warnings need guidance
neovim/neovim1⭐ 91433Security-related warnings and error messages should provide clear, actionable guidance on how users can saf...
-
Prefer opt-in security
neondatabase/neon1⭐ 19015When implementing security features that modify data presentation or alter normal data access patterns (lik...
-
Harden CI/CD runners
neondatabase/neon1⭐ 19015All CI/CD workflow jobs must implement security controls for network traffic, particularly using the step-s...
-
Escape SQL parameters
neondatabase/neon1⭐ 19015Always escape parameters in database connection strings to prevent SQL injection attacks. Direct string con...
-
Secure credential management
n8n-io/n8n1⭐ 122978Never hardcode sensitive information like passwords, API keys, or access tokens directly in code or configu...
-
Restrict database access
n8n-io/n8n1⭐ 122978Never allow unrestricted public access (0.0.0.0/0) to database instances. Restrict database network access ...
-
Avoid hardcoded credentials
n8n-io/n8n1⭐ 122978Never hardcode sensitive information such as passwords, API keys, or authentication tokens in source code, ...
-
Avoid eval function
apache/mxnet1⭐ 20801Never use the `eval()` function in Python code as it creates serious security vulnerabilities by executing ...
-
Use 404 over 403
mastodon/mastodon1⭐ 48691When blocking access to security-sensitive endpoints or directories, return HTTP 404 (Not Found) instead of...
-
referrer header privacy
mastodon/mastodon1⭐ 48691When implementing features that link to external sites, carefully consider referrer policies to prevent uni...
-
Default to minimum permissions
maplibre/maplibre-native1⭐ 1411Always default to the least invasive privacy settings and explicitly request elevated permissions only when...
-
Buffer bounds validation
maplibre/maplibre-native1⭐ 1411Always validate buffer boundaries before performing memory operations to prevent buffer overflow vulnerabil...
-
Prevent credential exposure
lobehub/lobe-chat1⭐ 65138Ensure that sensitive authentication data such as API keys, tokens, passwords, and other credentials are ne...
-
Design extensible permission systems
BerriAI/litellm1⭐ 28310When implementing authorization features, design permission systems that can accommodate future security re...
-
avoid hardcoded credentials
BerriAI/litellm1⭐ 28310Never embed sensitive credentials, passwords, API keys, or other secrets directly in source code. Hardcoded...
-
Encrypt sensitive credentials
langfuse/langfuse1⭐ 13574Sensitive credentials such as API keys, passwords, access tokens, and secret keys should never be stored in...
-
Avoid automatic package execution
langfuse/langfuse1⭐ 13574Using `npx --yes` bypasses security prompts and automatically installs packages without verification, which...
-
Use fake sample data
langflow-ai/langflow1⭐ 111046Always use completely fictional personal information in sample files, documentation, test data, and code ex...
-
minimize security dependencies
kubernetes/kubernetes1⭐ 116489For security-sensitive operations like shell argument parsing, input validation, or cryptographic functions...
-
minimize RBAC permissions
kubernetes/kubernetes1⭐ 116489When defining RBAC rules and authorization policies, grant only the minimum necessary permissions required ...
-
Private vulnerability reporting
kubeflow/kubeflow1⭐ 15064Never expose security vulnerabilities in public issue trackers. Security issues require confidential handli...
-
Prevent XSS vulnerabilities
kubeflow/kubeflow1⭐ 15064Never directly concatenate untrusted data (like user inputs or API responses) into HTML strings, as this cr...
-
Harden container security
kubeflow/kubeflow1⭐ 15064When building container images, ensure they're compatible with restricted Kubernetes security contexts. Use...
-
Enforce HTTPS protocol
kubeflow/kubeflow1⭐ 15064Always validate that URLs use the HTTPS protocol in both implementation code and validation error messages....
-
Control header modification
kubeflow/kubeflow1⭐ 15064When allowing user-configurable HTTP headers in your application, implement strict validation to prevent se...
-
Configurable security with defaults
kubeflow/kubeflow1⭐ 15064Make security features configurable through environment variables or configuration files, but always implem...
-
Document security implementations
JetBrains/kotlin1⭐ 50857Always document non-obvious security implementations, especially authentication mechanisms, with explanator...
-
Evaluate CI secret exposure
kilo-org/kilocode1⭐ 7302Before using secrets in CI/CD workflows that can be triggered by external contributors (forks, dependabot),...
-
verify authorization permissions
apache/kafka1⭐ 30575Ensure that authorization checks use the appropriate permission level for the specific operation being perf...
-
Secure GPG verification
apache/kafka1⭐ 30575When downloading and verifying packages using GPG signatures, follow secure practices to ensure authenticit...
-
avoid password conversions
apache/kafka1⭐ 30575When handling sensitive data like passwords, avoid unnecessary type conversions that create additional copi...
-
Avoid external URLs
menloresearch/jan1⭐ 37620Links to external repositories or domains in documentation and code can create security vulnerabilities thr...
-
Document security behavior references
istio/istio1⭐ 37192When implementing security-related functionality such as certificate parsing, cryptographic validation, or ...
-
audit license dependencies
istio/istio1⭐ 37192Always verify the licensing compatibility of all dependencies, especially in security-critical networking c...
-
Vet security-critical dependencies
influxdata/influxdb1⭐ 30268When introducing new dependencies, especially those handling sensitive operations like language interpreter...
-
Secure dependency management
elie222/inbox-zero1⭐ 8267Always maintain secure dependencies by following these two critical security practices: 1. **Keep dependen...
-
Quote shell substitutions
elie222/inbox-zero1⭐ 8267Always enclose command substitutions in double quotes when assigning to variables or using in shell scripts...
-
Enforce user scoping
elie222/inbox-zero1⭐ 8267All database queries must include appropriate user scoping to prevent unauthorized data access and Insecure...
-
prefer specific cryptographic libraries
juspay/hyperswitch1⭐ 34028When adding cryptographic dependencies, critically evaluate whether broad libraries like OpenSSL are necess...
-
Use appropriate permission checks
grafana/grafana1⭐ 68825When implementing role-based access control (RBAC), ensure you use the correct permission verification meth...
-
Update vulnerable dependencies
grafana/grafana1⭐ 68825Always update dependencies with known security vulnerabilities to their patched versions. Dependencies with...
-
Avoid plaintext credentials
grafana/grafana1⭐ 68825Never include plaintext passwords or credentials in connection strings, configuration files, or documentati...
-
inline external dependencies
block/goose1⭐ 19037For security-critical applications, prefer inlining external dependencies (JavaScript libraries, CSS framew...
-
Secure temporary files
ghostty-org/ghostty1⭐ 32864Always use `mktemp` instead of manually constructing temporary file paths with random values. Manually cons...
-
Sanitize debug output
ghostty-org/ghostty1⭐ 32864Never print or log sensitive information such as tokens, passwords, or secrets that might be present in env...
-
test security end-to-end
google-gemini/gemini-cli1⭐ 65062Security features must be tested using the actual executable or CLI rather than just module-level unit test...
-
secure authentication flows
google-gemini/gemini-cli1⭐ 65062Authentication flows should be designed to provide a seamless user experience while maintaining security st...
-
Generic security configuration naming
google-gemini/gemini-cli1⭐ 65062When implementing security-related configuration options, use generic, implementation-agnostic naming conve...
-
Non-root container users
fatedier/frp1⭐ 95938Always run containers with a non-root user to reduce the security attack surface. Modern Docker allows non-...
-
secure XML parsing
firecrawl/firecrawl1⭐ 54535When configuring XML parsing options, carefully evaluate security implications of each setting, especially ...
-
remove unnecessary authentication
firecrawl/firecrawl1⭐ 54535Avoid initializing authentication mechanisms, credentials, or identity objects when they are not actually u...
-
Secure Content-Type validation
fastify/fastify1⭐ 34000When implementing Content-Type validation, ensure regular expressions start with '^' or include ';?' to pro...
-
Use unique password salts
expressjs/express1⭐ 67300When implementing password hashing, always use unique, randomly generated salts for each user. Using consta...
-
Pin action commit hashes
expressjs/express1⭐ 67300Always pin third-party GitHub Actions to specific commit hashes rather than semantic version tags (like `@v...
-
strip event parameters
electron/electron1⭐ 117644When exposing IPC event handlers through contextBridge in Electron applications, always strip the event par...
-
Remove internal APIs
electron/electron1⭐ 117644Delete internal system properties and APIs after use to prevent application code from accessing protected f...
-
Enforce least privilege
elastic/elasticsearch1⭐ 73104Always assign the minimum permissions necessary for functionality when implementing role-based access contr...
-
Limit postMessage data exposure
dyad-sh/dyad1⭐ 16903When using postMessage for inter-window communication, avoid sending raw event data or generic message type...
-
Escape untrusted input
django/django1⭐ 84182Always use appropriate escaping mechanisms when handling input from untrusted sources to prevent injection ...
-
use Guardian authorization classes
discourse/discourse1⭐ 44898Always implement authorization checks using Guardian classes rather than ad-hoc permission logic. Guardian ...
-
enforce consistent SSO flows
discourse/discourse1⭐ 44898When single sign-on (SSO) is enabled as the primary authentication mechanism, ensure all authentication ent...
-
disable sensitive data defaults
zen-browser/desktop1⭐ 34711Features that handle sensitive data such as credit card information, passwords, or personal details should ...
-
Document security policy trade-offs
cypress-io/cypress1⭐ 48850When implementing security policies like Content Security Policy (CSP), always include clear documentation ...
-
Clear security error messages
cypress-io/cypress1⭐ 48850When implementing security restrictions or policies, ensure error messages clearly explain what the securit...
-
trust server-side validation
home-assistant/core1⭐ 80450When integrating with external APIs or services that implement their own input validation, avoid duplicatin...
-
classify data sensitivity
home-assistant/core1⭐ 80450Properly evaluate whether data contains sensitive information before applying security measures like redact...
-
Prevent injection vulnerabilities
continuedev/continue1⭐ 27819When constructing templates or dynamic content that will be parsed, always implement robust escaping mechan...
-
Accessible security controls
continuedev/continue1⭐ 27819Security controls and interactive elements must be accessible to all users to prevent unequal security acce...
-
Use organizational secrets
docker/compose1⭐ 35858When working with GitHub Actions workflows that require shared credentials or tokens, leverage organization...
-
precise security pattern matching
docker/compose1⭐ 35858When checking for security features or configurations in shell scripts, use precise pattern matching to avo...
-
minimize credential access scope
docker/compose1⭐ 35858Apply the principle of least privilege when managing credentials in CI/CD pipelines and application code. U...
-
Restrict command whitelist
openai/codex1⭐ 31275When configuring command whitelists for auto-approval, include only commands with limited capabilities that...
-
Prevent command injection
openai/codex1⭐ 31275Always use child_process.spawn() with array arguments instead of exec() with string concatenation when exec...
-
Explicit security bypass
openai/codex1⭐ 31275When implementing functionality to bypass security controls (like sandboxing), ensure the bypass is complet...
-
validate SVG security context
cline/cline1⭐ 48299SVG files can execute code when loaded, making them a potential security vulnerability. Before using SVGs, ...
-
Restrict external dependencies
cline/cline1⭐ 48299Dependencies from packages outside your organization's trusted domain pose security risks and should be avo...
-
avoid interactive authentication automation
cline/cline1⭐ 48299When building scripts or applications that require user authentication, avoid automating interactive authen...
-
Document authentication precedence
ClickHouse/ClickHouse1⭐ 42425When implementing systems that support multiple authentication methods, always clearly document which authe...
-
Use secure hash functions
snyk/cli1⭐ 5178When hashing sensitive data such as authentication tokens, always use cryptographically secure hash functio...
-
Pin dependency versions
anthropics/claude-code1⭐ 25432Always pin external dependencies to specific commit hashes rather than mutable references like tags or bran...
-
Least privilege networking
anthropics/claude-code1⭐ 25432Restrict network access to only what's necessary for your application to function, using explicit allowlist...
-
Avoid privileged installations
anthropics/claude-code1⭐ 25432Always recommend user-level package installations rather than using administrative/root privileges. Install...
-
Update security-critical dependencies
chef/chef1⭐ 7860Regularly audit and update third-party libraries and dependencies to address known security vulnerabilities...
-
Expand IAM wildcards
bridgecrewio/checkov1⭐ 7668Always expand IAM wildcard permissions (`*`) to specific actions for thorough security analysis. Wildcard p...
-
Avoid wildcard permissions
bridgecrewio/checkov1⭐ 7667Implement the principle of least privilege by avoiding wildcard permissions (e.g., '*') in access control p...
-
Avoid hardcoded secrets
bridgecrewio/checkov1⭐ 7668Never include hardcoded secrets or credentials in your infrastructure as code files. Secrets in configurati...
-
Verify cryptographic function behavior
oven-sh/bun1⭐ 79093When implementing cryptographic algorithms, always verify the exact behavior and return values of security-...
-
Validate buffer boundaries
oven-sh/bun1⭐ 79093When calling functions that process buffers, especially external C functions, always provide explicit buffe...
-
Secure credentials handling
oven-sh/bun1⭐ 79093When handling credentials or secrets in code, avoid passing them directly through command substitution or t...
-
prefer authentication tokens
browser-use/browser-use1⭐ 69139When configuring authentication in CI/CD workflows, prefer using tokens over passwords for enhanced securit...
-
Evaluate security control effectiveness
Homebrew/brew1⭐ 44168Security measures should be evaluated against realistic threat models to avoid creating a false sense of se...
-
Use standard example credentials
boto/boto31⭐ 9417When including API keys, access tokens, or other credentials in documentation, examples, or test code, alwa...
-
prefer authentication wrappers
better-auth/better-auth1⭐ 19651Use authentication wrapper functions or higher-order functions that automatically handle unauthenticated ca...
-
temporary security workarounds
bazelbuild/bazel1⭐ 24489When implementing workarounds for OS-level security restrictions, ensure they are explicitly temporary and ...
-
Redact sensitive information
Azure/azure-sdk-for-net1⭐ 5809Always sanitize configuration data or any potentially sensitive information before logging or displaying it...
-
Externalize sensitive credentials
Azure/azure-sdk-for-net1⭐ 5809Never hardcode sensitive values such as client identifiers, API keys, connection strings, or passwords dire...
-
Complete authentication testing
Azure/azure-sdk-for-net1⭐ 5809Always verify both positive and negative authentication scenarios in your security tests. For each authenti...
-
Secure cookie configuration
tokio-rs/axum1⭐ 22100Always set appropriate security flags on cookies, especially those used for authentication or session manag...
-
Isolate sensitive buffer data
aws/aws-sdk-js1⭐ 7628When handling sensitive data in Node.js, protect against data leakage by isolating sensitive content in ded...
-
Vet dependency supply chains
avelino/awesome-go1⭐ 151435When adding new dependencies, especially security-related ones, thoroughly evaluate them for supply chain a...
-
validate external URLs
argoproj/argo-cd1⭐ 20149Always validate and sanitize external URLs before opening them or using them in navigation operations to pr...
-
consolidate RBAC permissions
argoproj/argo-cd1⭐ 20149Avoid duplicating RBAC permissions across different deployment configurations or installation modes. When t...
-
Verify authentication logic
appwrite/appwrite1⭐ 51959Ensure authentication validation logic follows expected semantics and intuitive implementation. Authenticat...
-
Use proper authentication
appwrite/appwrite1⭐ 51959Always implement the correct authentication method for API clients as specified in the SDK documentation. I...
-
Secure file uploads
appwrite/appwrite1⭐ 51959Always implement and maintain robust scanning mechanisms for user-uploaded files to prevent malware distrib...
-
Secure credentials management
appwrite/appwrite1⭐ 51959Never store sensitive credentials (passwords, API keys, tokens, etc.) in plain text within code repositorie...
-
validate disabled state accessibility
ant-design/ant-design1⭐ 95882When UI components with interactive elements (like buttons with href attributes) are disabled, ensure they ...
-
Prioritize secure token storage
apache/airflow1⭐ 40858When implementing authentication token handling, prioritize more secure storage mechanisms over less secure...
-
Document security exceptions
apache/airflow1⭐ 40858When disabling security-related linter rules or bypassing security best practices, always include comments ...