Home / Workflow Prompts
Engineering Workflow SOPs
58+ Standard Operating Procedures for reading, debugging, refactoring, and shipping code with AI IDEs.
Exploring a New Codebase - First-pass repo review: stack, folder tree, key files, run commands.
Understanding the Architecture - Map layers, communication paths, and architecture violations.
Building a Feature with Little Context - Investigate patterns and produce an implementation plan before coding.
Tracing How the Backend Works - Follow an endpoint from route definition to final response.
Understanding How APIs Are Running - Catalog every API endpoint and flag security/consistency issues.
Solving a Bug, Tracing Logical Flow - Trace logical flow and locate the root cause before changing code.
Reviewing a PR You Did Not Write - Strict senior-engineer PR review with prioritized findings.
Onboarding a Legacy Codebase - Inherit an undocumented system and map fragile areas.
Finding Where a Behavior Is Implemented - Locate exact implementation of a behavior, not just filenames.
Refactoring Without Breaking Hidden Dependencies - Map all dependents before refactoring, then plan safe steps.
Understanding How Data Flows - Trace a specific piece of data from creation to storage and display.
Checking If a Change Is Safe to Ship - Review uncommitted changes before opening a PR.
Why a Test Is Failing - Trace a failing test to determine whether code or test is wrong.
Auditing Security & Attack Surface - Static security review with prioritized remediation.
Mapping Test Coverage & Risk - Map test coverage to critical paths and prioritize missing tests.
Tracing a Performance Bottleneck - Trace a slow operation and locate the bottleneck before fixing.
Debugging a Flaky Test - Diagnose and fix non-deterministic test failures.
Debugging a Production Incident from Logs - Build a timeline and root-cause analysis from logs and stack traces.
Writing a Database Migration Safely - Plan a reversible migration with rollback and zero-downtime steps.
Integrating an External API - Design a robust external API integration following repo patterns.
Adding a New API Endpoint Following Conventions - Plan a new endpoint by matching existing patterns exactly.
Characterizing Legacy Code with Tests - Pin down untested legacy behavior before making changes.
Preparing a PR Description & Test Plan - Generate a clear PR description with test plan and risk assessment.
Writing a Rollback & Release Plan - Create a zero-downtime release plan with rollback steps.
Post-Incident Review - Facilitate a blameless postmortem with clear action items.
Tracing a Component's State & Re-renders - Trace frontend render paths, state changes, and stale UI behavior.
Accessibility Audit - WCAG 2.2 AA audit with prioritized fixes.
Diagnosing a Layout or Responsive Bug - Find the offending CSS or component structure before changing it.
Auditing Outdated & Vulnerable Dependencies - Review dependency health, security, and maintenance risk.
Evaluating Whether to Add a New Dependency - Assess bundle, maintenance, and alternatives before installing.
Assessing a Major Version Upgrade - Investigate breaking changes and blast radius before upgrading.
Estimating & Sizing a Feature Before Building - Understand complexity, risk, and unknowns before planning.
Auditing Naming & Pattern Consistency Across the Repo - Find drift, duplicate utilities, and inconsistent conventions.
Tracing an Authentication & Authorization Flow - Workflow prompt for Tracing an Authentication & Authorization Flow.
Tracing Error Handling & Recovery Paths - Workflow prompt for Tracing Error Handling & Recovery Paths.
Mapping Feature Flags & Configuration - Workflow prompt for Mapping Feature Flags & Configuration.
Reading and Explaining a Stack Trace - Workflow prompt for Reading and Explaining a Stack Trace.
Debugging a Memory Leak - Workflow prompt for Debugging a Memory Leak.
Debugging a Race Condition or Concurrency Bug - Workflow prompt for Debugging a Race Condition or Concurrency Bug.
Debugging a Deadlock - Workflow prompt for Debugging a Deadlock.
Debugging an Environment-Specific Bug - Workflow prompt for Debugging an Environment-Specific Bug.
Setting Up a Local Development Environment - Workflow prompt for Setting Up a Local Development Environment.
Writing Unit Tests for Existing Code - Workflow prompt for Writing Unit Tests for Existing Code.
Adding a Feature Flag Safely - Workflow prompt for Adding a Feature Flag Safely.
Building a CLI Tool or Script - Workflow prompt for Building a CLI Tool or Script.
Creating an API Client Module - Workflow prompt for Creating an API Client Module.
Mocking External Services for Tests - Workflow prompt for Mocking External Services for Tests.
Writing a Post-Deployment Verification Checklist - Workflow prompt for Writing a Post-Deployment Verification Checklist.
Writing a Changelog & Release Notes - Workflow prompt for Writing a Changelog & Release Notes.
Planning a Canary Release or Gradual Rollout - Workflow prompt for Planning a Canary Release or Gradual Rollout.
Auditing Logging & Observability - Workflow prompt for Auditing Logging & Observability.
Auditing Error Messages & API Responses - Workflow prompt for Auditing Error Messages & API Responses.
Auditing CI Pipeline & Build Health - Workflow prompt for Auditing CI Pipeline & Build Health.
Explaining the Entire Project in Detail - Act as a senior staff engineer producing a complete, professional explanation of this repository for a new senior engineer.
Technical SEO, Performance & Web Platform Audit - Act as a senior technical SEO and web performance specialist to audit a project's public web presence.
Documentation & Developer Onboarding Audit - Audit the documentation and developer onboarding experience of a repository for a new engineer.
Production Readiness & Reliability Audit - Act as a senior SRE auditing a codebase for production readiness, configuration, logging, and scaling.
Code Health & Maintainability Deep Audit - Audit the long-term maintainability of a codebase focusing on complexity, duplication, and boundaries.