Graphql
Write, explain, or optimize a GraphQL operation or schema — queries, mutations, fragments, resolvers — with attention to the real schema, over-fetching, and the N+1 problem. Use when the user says "write a GraphQL query", "explain this query", "why is this resolver slow", "design a GraphQL schema", "fix N+1 in resolvers", or pastes an operation and asks what it does.
Deps
Audit the project's dependencies for outdated, deprecated, or vulnerable packages and recommend a safe upgrade path. Use when the user says "check dependencies", "audit deps", "are my packages out of date", "any vulnerabilities", "what should I upgrade", or "check for CVEs".
I18n
Extract hardcoded user-facing strings into the project's localization system — locale files and translation calls — so the UI can be translated. Use when the user says "extract strings for translation", "internationalize this", "set up i18n", "move text to locale files", "add translation keys", or "make this translatable".
Refactor
Restructure a file, function, or module toward a stated goal (readability, decoupling, extracting logic, reducing duplication) without changing its behavior. Use when the user says "refactor this", "clean up this function", "extract this into", "decouple", "restructure", or "make this more readable".
Coverage
Run the test suite with coverage and report the least-covered files and functions, with concrete suggestions for the next tests to write. Use when the user says "check test coverage", "what's not tested", "run coverage", "where are the coverage gaps", "how covered is this", or "what should I test next".
Graceful Shutdown
Make a service shut down cleanly on SIGTERM/SIGINT — stop accepting new work, drain in-flight requests, close DB/queue connections, and exit within the platform's grace period — so deploys and restarts don't drop requests or corrupt state. Use when the user says "add graceful shutdown", "handle SIGTERM", "drain connections on shutdown", "stop dropping requests during deploys", "close connections…
Readme
Generate or update a project README from the codebase — what it is, how to install, run, test, and configure it. Use when the user says "write a README", "generate a readme", "update the README", "document this project", "my README is out of date", or "create project docs".
License
Add or update an open-source LICENSE file for the project, filling in the right SPDX license, copyright holder, and year, and optionally inserting license headers into source files. Use when the user says "add a license", "what license should I use", "add MIT/Apache license", "add license headers", or "set up licensing".
Pre Commit
Set up or improve pre-commit hooks that lint, format, and check the project before each commit, matching its language and tooling. Use when the user says "set up pre-commit hooks", "add a git hook", "run lint before commit", "configure husky", "add pre-commit", or "block bad commits".
Connection Pool
Configure or fix a database/HTTP connection pool — right-size it, set acquire/idle/lifetime timeouts, and avoid exhaustion and leaked connections — so the app stays responsive under load instead of stalling on connection waits. Use when the user says "configure the connection pool", "tune pool size", "I'm getting pool timeout / too many connections", "connections are leaking", "size the DB pool",…
Explain
Explain a file, function, or recent diff in plain language — what it does, how it flows, and why. Use when the user asks to explain code, says "what does this do", "walk me through this file", "help me understand this", "explain the diff", or is onboarding to unfamiliar code.
Audit Log
Add an audit trail that records who did what, when, and to what — for security-sensitive and compliance-relevant actions (logins, permission changes, data mutations, admin operations) — in an append-only, tamper-evident, PII-conscious way. Use when the user says "add an audit log", "track who changed what", "add an audit trail", "record admin actions", "who did this and when", "add compliance log…
Dockerize
Generate a production-ready Dockerfile, .dockerignore, and optional docker-compose for the project, matching its language and build setup. Use when the user says "dockerize this", "write a Dockerfile", "containerize the app", "add docker-compose", or "how do I run this in a container".
Onboard
Orient a developer to an unfamiliar codebase — how to build and run it, the high-level architecture, key directories, and where to start. Use when the user says "help me understand this repo", "onboard me", "what is this project", "how do I run this", "give me the lay of the land", or "where do I start".
Env Example
Scan the codebase for environment variable usage and generate or update a .env.example with every required variable, documented and safely placeholdered. Use when the user says "generate a .env.example", "what env vars does this need", "document the environment variables", "update my dotenv template", or "find missing env vars".
Commit Message
Generate a conventional commit message from staged git changes. Use when the user asks to commit, write a commit message, says "commit this", "what should the commit message be", or "prepare a commit".
Prune Branches
Clean up stale git branches — local and remote — that are already merged or long abandoned, safely and with confirmation. Use when the user says "clean up branches", "delete merged branches", "prune stale branches", "remove old branches", "tidy up git branches", or "which branches can I delete".
Dead Code
Find unused code — unreferenced exports, functions, variables, imports, files, and dependencies — and propose safe removals. Use when the user says "find dead code", "what's unused", "remove unused imports", "find unreferenced functions", "what can I delete", or "clean up dead code".
Migrate
Apply a sweeping, mechanical change consistently across the whole codebase — rename an API, swap a library or pattern, update a deprecated call — then verify nothing broke. Use when the user says "migrate all", "rename X everywhere", "replace every use of", "codemod", "update all callers", or "switch the project from X to Y".
A11y
Audit the UI for accessibility problems — missing labels, alt text, contrast, keyboard traps, ARIA misuse, semantic structure — and fix them against WCAG. Use when the user says "check accessibility", "audit a11y", "is this accessible", "fix accessibility issues", "add aria labels", "screen reader support", or "WCAG compliance".
Regex
Build, explain, or debug a regular expression from a plain-English description, with worked examples and test cases. Use when the user says "write a regex", "regex for", "explain this regex", "why doesn't this pattern match", "match a pattern like", or pastes a regex and asks what it does.
Changelog
Generate a changelog entry from recent git commits. Use when the user asks to update the changelog, write release notes, says "prepare a release", "what changed recently", or "generate release notes".
Lint Fix
Detect the project's linter and formatter, run them, and fix the reported problems — auto-fixable ones first, then the rest by hand — without changing behavior. Use when the user says "fix the lint errors", "run the linter", "format this code", "clean up lint warnings", "make lint pass", or "fix formatting".
Cache
Add a caching layer to an expensive function, query, or endpoint — in-memory, Redis, or HTTP — with correct keys, TTL, and invalidation. Use when the user says "add caching", "cache this result", "memoize this", "cache the API response", "add a Redis cache", or "this is recomputed too often".
Mock
Generate test doubles — mocks, stubs, fakes, spies — for a unit's external dependencies, matching the project's testing and mocking approach, so a unit test can run in isolation. Use when the user says "mock this dependency", "create a stub for", "mock the API call", "fake the database", "add a test double", or "how do I mock X in tests".
Pagination
Add pagination to a list endpoint or query that returns unbounded rows — offset/limit or cursor-based — so responses stay fast and bounded as the dataset grows. Use when the user says "add pagination", "paginate this endpoint", "this returns too many rows", "add limit and offset", "add cursor pagination", "page through results", or "the list query is slow with lots of data".
Healthcheck
Add health, readiness, and liveness check endpoints to a service — verifying dependencies (db, cache, queues) — matching the project's framework, for load balancers and orchestrators. Use when the user says "add a health check", "add a /health endpoint", "add readiness/liveness probes", "health endpoint for Kubernetes", or "how do I check if the service is up".
Cherry Pick
Apply specific commits from one branch onto another with git cherry-pick — backport a fix, pull a single feature commit across branches, or recover a commit — safely and with conflict handling. Use when the user says "cherry-pick this commit", "backport this fix to the release branch", "apply commit X to main", "bring that commit over here", "port this change to another branch", or "I need just o…
Idempotency
Make a write endpoint or operation safe to retry by adding idempotency keys — so a duplicate request (from a client retry, double-click, or network timeout) produces one effect, not two. Use when the user says "add idempotency", "make this endpoint idempotent", "prevent duplicate charges", "add an idempotency key", "deduplicate requests", "handle double submits", or "this can be called twice and…
Api Docs
Generate API documentation for the project's HTTP endpoints — an OpenAPI spec or a readable markdown reference — by reading the route handlers. Use when the user says "document the API", "generate OpenAPI", "write API docs", "list the endpoints", "create a Swagger spec", or "document these routes".
Codeowners
Generate or update a CODEOWNERS file mapping paths to owning people or teams, so the right reviewers are auto-requested on PRs. Use when the user says "add a CODEOWNERS file", "set up code owners", "who should review which files", "auto-assign reviewers", or "map directories to teams".
Db Migrate
Generate a database schema migration from a described change — add a table/column, alter a type, add an index or constraint — using the project's migration tool, with a safe up and down. Use when the user says "create a migration", "add a column to the database", "generate a schema migration", "alter this table", "add an index", or "migrate the database schema".
Gitignore
Generate or tighten a .gitignore for the project's stack, and flag already-tracked files that should be ignored. Use when the user says "create a gitignore", "update my gitignore", "what should I ignore", "stop tracking this file", or "add X to gitignore".
Debug
Diagnose a bug from a symptom — an error message, stack trace, failing test, or wrong output — find the root cause, and propose a fix. Use when the user says "debug this", "why is this failing", "I'm getting this error", "this isn't working", "track down this bug", or pastes a stack trace.
Error Handling
Audit and harden error handling in a file or module — swallowed exceptions, unhandled rejections, missing boundaries, bare catches, leaked internals — and fix the gaps. Use when the user says "improve error handling", "audit error handling", "handle errors properly", "fix swallowed exceptions", "add error boundaries", or "make this more robust".
Benchmark
Measure the runtime, throughput, or memory of a function, endpoint, or command — establish a baseline and report the numbers, using the project's benchmark tooling. Use when the user says "benchmark this", "how fast is this", "measure performance", "time this function", "set up a benchmark", or "what's the baseline".
Ci Setup
Generate or improve a CI pipeline (GitHub Actions by default) that installs, lints, tests, and builds the project, matching its language and tooling. Use when the user says "set up CI", "add GitHub Actions", "write a CI pipeline", "add a test workflow", or "automate my builds".
Feature Flag
Gate a feature or code path behind a feature flag — using the project's flag system (LaunchDarkly, Unleash, a config/env toggle) — so it can be shipped dark and rolled out or rolled back without a deploy. Use when the user says "put this behind a feature flag", "add a feature toggle", "gate this feature", "make this configurable on/off", or "ship this dark".
Bisect
Find the commit that introduced a regression using git bisect, guided by a description of what broke and a way to test it. Use when the user says "find the commit that broke this", "bisect this regression", "when did this stop working", "git bisect", or "what change caused this bug".
Optimize
Find and fix performance bottlenecks in a function, file, or hot path — slow loops, N+1 queries, redundant work, bad complexity, excess allocations. Use when the user says "optimize this", "this is slow", "improve performance", "speed this up", "why is this slow", or "reduce latency/memory".
Rebase
Replay a branch's commits onto a new base with git rebase — update a feature branch onto the latest main, move commits onto a different base, or linearize history — safely, with conflict handling and a recovery path. Use when the user says "rebase onto main", "update my branch with the latest main", "replay my commits", "move my branch onto", "rebase this branch", or "get the latest changes into…
E2e
Write or scaffold end-to-end / integration tests that drive the app like a user — browser flows (Playwright/Cypress) or API flows — matching the project's setup. Use when the user says "write an e2e test", "add end-to-end tests", "set up Playwright/Cypress", "test this user flow", "add integration tests", or "test the happy path through the app".
Profile
Profile a program to find where it actually spends time or memory — capture a CPU/heap profile under a realistic workload, read the hot paths, and point to the real bottleneck before optimizing. Use when the user says "profile this", "where does the time go", "find the hotspot", "why is this using so much memory", "capture a flamegraph", "which function is slow", or "find the bottleneck before I…
Logging
Add or improve logging in a file or module — structured, leveled, contextual — using the project's existing logger, without leaking secrets or spamming. Use when the user says "add logging", "improve the logging", "add structured logs", "what should I log here", "set up a logger", or "add observability".
Docstring
Add or update documentation comments (docstrings, JSDoc, etc.) for changed or selected code, matching the project's existing style. Use when the user asks to document code, add docstrings, says "add JSDoc", "document this function", "write doc comments", or "add comments to the changes".
Diagram
Generate a Mermaid diagram from the codebase — architecture/module graph, entity-relationship, sequence, or flowchart — read from the actual code. Use when the user says "draw a diagram", "diagram the architecture", "generate an ER diagram", "make a sequence diagram", "visualize this flow", or "show how these pieces connect".
Pr Description
Generate a pull request title and description from the current branch diff. Use when the user asks to create a PR, write a PR description, says "open a PR", "draft a PR", "what should the PR say", or "prepare a pull request".
Rate Limit
Add rate limiting / throttling to an endpoint or service — protecting against abuse, brute force, and overload — using the project's framework and a shared store where needed. Use when the user says "add rate limiting", "throttle this endpoint", "limit requests per user", "prevent brute force", "add a request quota", or "protect this API from abuse".
Flaky Test
Track down and stabilize a flaky test — one that passes and fails non-deterministically — by finding the source of nondeterminism (timing, ordering, shared state, randomness, real I/O) and fixing the root cause, not by adding retries. Use when the user says "this test is flaky", "fix the flaky test", "the test passes sometimes", "stabilize this test", "why does this test fail intermittently", or…
Contributing
Generate or update a CONTRIBUTING.md for the project — how to set up, the dev workflow, branch/commit/PR conventions, and how to run tests and checks — read from the codebase. Use when the user says "write a CONTRIBUTING guide", "add contribution guidelines", "document the dev workflow", "how should people contribute", or "create a CONTRIBUTING.md".