Agent Budget Exhausted Halfway Through the Task
Your agent burns its token or cost budget before finishing and leaves work half-done. Diagnose where the spend went, recover the partial work, and resume from a checkpoint.
#Troubleshooting
Articles tagged with #Troubleshooting
Restored Agent Checkpoint Is Corrupted
Your agent resumes from a checkpoint but the state is garbled, missing fields, or wrong-typed. Detect the corruption, recover from a good generation, and write crash-durable checkpoints.
Cost Tracking Misses Sub-Agent Usage
Your pipeline reports $2 but the invoice says $18. Sub-agent token usage isn't attributed to the parent run. Here's how to close the gap, verified June 2026.
Cycle in Agent Call Graph Goes Undetected
Agents hand off to each other in a loop that never terminates because nothing checks for cycles. Here is how to catch the cycle, set the right framework limit, and bound the loop for good.
Agent Handoff Loses Context Between Steps
A downstream agent re-asks answered questions or contradicts earlier decisions. Find the lossy handoff boundary and wire durable, structured state in under an hour.
Agent Leaked an API Key in Its Output: Rotate and Lock It Down
An AI agent echoed a secret key, token, or connection string in its response or a tool call. Rotate it in minutes, audit for misuse, and block the model from ever seeing raw secrets again.
Agent Orchestrator Deadlocks Waiting on Each Other
Two agents block forever waiting for each other's output. Find the cycle, add a timeout, and break the deadlock in minutes — with LangGraph, Temporal, and AutoGen specifics.
Fix: Agent Output Leaks Secrets Into Logs and Git
An AI agent wrote a real API key, token, or password into your logs, traces, or a committed file. Here is the fastest containment path, plus how to scrub output and stop it recurring.
Agent Output Not Machine-Parseable Downstream
Your agent wraps JSON in a markdown fence or adds prose, so the downstream parser crashes. Fix it for good with native structured outputs (June 2026).
Agent Skipped a Pre-flight Check It Was Supposed to Run
Your agent ran without its required pre-flight checks and failed hours later on a problem it could have caught in seconds. Here is how to make those checks a blocking gate that no code path can skip.
Agent Promotion Criteria Too Loose: Bad Output Slips Through
Your agent pipeline promotes flawed output because the quality gate is too broad or easy to satisfy. Tighten gates with critical-vs-cosmetic weighting, grounded checks, and adversarial tests without over-blocking.
Fix Prompt Template Drift Between Agent Versions
Different agent instances run subtly different system prompts, so output quality changes depending on which one handles a request. Here's how to pin prompt versions, log the exact prompt per run, and detect drift before it ships.
One Agent's Rate Limit Cascades Into a Chain Failure
One rate-limited agent stalls the whole pipeline as waiting agents time out. Isolate the bucket, decouple stages, and stop 429 cascades for good.
Flaky Tool Triggers an Agent Retry Storm
One unreliable tool call makes your agent retry hundreds of times, burning budget and tripping rate limits. Add a retry cap, backoff with jitter, 429 handling, and a circuit breaker.
Agent Skipped a Required Validation Step
Your agent pipeline promoted unvalidated output because a lint/test gate was skipped. Enforce non-skippable validation in LangGraph, CrewAI, OpenAI Agents SDK, and Claude Code.
Agent State Desyncs After Restart: Detect Drift and Resync
After a crash or restart, your agent thinks the world is in a state that no longer matches reality. Here's how to detect the drift and resync reliably with LangGraph, Temporal, and custom checkpoints.
Shared Agent Memory Corrupted by Overlapping Writes
Two agents read the same shared memory, both write back, and one update silently vanishes. Diagnose the lost-update race and fix it with atomic ops, optimistic locking, or per-agent partitions.
Agent's Subprocess Orphaned After the Agent Exits
An AI agent launches a dev server or watcher, then exits without killing it. The process keeps holding a port and burning CPU. Here is how to track every subprocess and guarantee it dies.
Task Routed to the Wrong Agent: Fix Misclassified Routing
Your CrewAI, LangGraph, or AutoGen router sends tasks to the wrong specialist agent and produces garbage. Diagnose the routing logic and fix the misclassification.
Agent Trace Missing a Tool Call: Find the Gap and Fix It
Your LangSmith or Langfuse trace shows a result but no tool call span. Here's how to find which of seven causes you hit and make traces complete again.
Roleplay Bypasses Your AI Content Filter
A user tells your AI to play a character with 'no restrictions' and it produces policy-violating output. Detect roleplay filter bypass in logs and add output-side guardrails that actually hold.
AI Follows Malicious Instructions Hidden in an Uploaded File
An uploaded file carries hidden instructions that hijack the AI mid-task. Detect white-text, Unicode-smuggled, and metadata payloads, sanitize uploads, and block file-triggered tool calls.
Your AI Tool Accidentally Wrote Phishing Content
Your AI content tool produced a convincing phishing email or credential-harvesting page because the request was reframed as marketing or training. How to detect the three-signal pattern and add output-side intent gates.
Data Exfiltration via Image URL
An AI agent encodes sensitive data into a Markdown image URL and the chat UI auto-loads it, leaking data to an attacker's server. How to detect the gadget and break the chain.
git bisect Stuck on Skipped Commits
git bisect keeps skipping commits and ends with 'The first bad commit could be any of...' instead of one SHA. Skip whole ranges, use exit code 125, and fix the underlying build/environment problem to finish the bisect.
Branch Protection Blocks a Legitimate Merge
Your PR has approvals and green CI but GitHub, GitLab, or Bitbucket still won't let you merge. Find the exact rule that's failing and clear it without weakening protection.
Cherry-pick Became Empty After Resolving Conflicts
Git stops a cherry-pick saying the commit is now empty after you resolved a conflict. When to run --skip, when to use --allow-empty, and why --empty=drop won't help here.
Git Credential Helper Locked: Every Pull and Push Fails
Git re-prompts for a password on every operation, hangs for 30 seconds, or fails with 403/401 because the credential helper is stale or misconfigured. Erase the cached credential and re-auth. Works for GitHub, GitLab, and Bitbucket.
I Committed in Detached HEAD — Now What?
Made commits in detached HEAD and they vanished after switching branches? Find the SHA in the reflog and attach it to a branch before git gc prunes it.
Force Push Overwrote Teammates' Commits
A git push --force wiped teammates' work from a shared branch. Recover the lost commits from the reflog or GitHub Activity view and stop it recurring.
Git Hooks Don't Run After Clone
Pre-commit and pre-push hooks stay silent after a fresh clone. Git never clones .git/hooks/ — here is why, plus the one-line core.hooksPath fix and a correct husky v9 / lefthook setup.
Git LFS Pointer Not Resolved Into the Real File
Your checked-out file is LFS pointer text, not the real binary. Run git lfs install then git lfs pull to fix it in two commands, plus how to diagnose why the smudge filter skipped.
Large File in History Blocks Your Git Push
GitHub rejects your push because a file over 100 MiB lives in history. Excise it from every commit with git-filter-repo, then force-push cleanly.
CRLF Conversion Blew Up a 2-Line Change Into a 3,000-Line Diff
A line-ending normalization turned a 2-line change into a 3,000-line CRLF/LF diff. Diagnose which bucket you're in, fix .gitattributes, renormalize, and stop it recurring.
Binary File Merge Conflict: Pick a Side and Unblock the Merge
Git marks a binary file as conflicted but shows no diff markers. Use git checkout --ours/--theirs to pick the right version and finish the merge in minutes.
Monorepo Partial Clone Has Stale or Missing Objects
A blobless monorepo clone shows empty, outdated, or missing files after a pull. Backfill the missing blobs, re-cone the sparse checkout, and stop it recurring.
git pull --rebase Scrambled My Conflict History
git pull --rebase stopped on a confusing conflict, then git log looks wrong — new SHAs, reordered commits, a 'fix conflict' commit. What is normal, what is broken, and how to recover.
Commits Disappeared After a Git Rebase
Your commits vanished after git rebase. Recover them from ORIG_HEAD or the reflog in under two minutes, with no data loss.
Git Revert Merge Commit: Fix 'no -m option was given'
git revert fails with 'commit is a merge but no -m option was given.' Learn which parent (-m 1 vs -m 2) to pick, revert the right changes, and re-merge later without losing them.
I Pushed a Secret to a Public Repo
An API key or password landed in a public GitHub repo. Rotate the key first, then purge it from history with git-filter-repo before a scraper uses it.
Git Stash Gone After Checkout — How to Recover It
Your git stash list is empty after switching branches and your work-in-progress changes have vanished. Find them in the stash reflog or with git fsck and restore them.
Git Submodule Won't Update to the Latest Commit
git submodule update keeps checking out an old commit, an empty folder, or a SHA that does not exist. Diagnose which of six causes you hit, then fix the pointer and sync.
Git Tag Points to the Wrong Commit
A release tag landed on the wrong commit and you already pushed it. Move the tag safely, force-fetch it on every clone, and handle the npm/GitHub Release caches that already pinned the old code.
Git Worktree Stale After You Delete Its Branch
A git worktree breaks after its branch was deleted or its directory was removed. Prune the stale registration, repair a moved worktree, or rescue uncommitted work — verified commands for Git 2.36+.
Prompt Injection Hidden Inside a PDF
A PDF carries invisible white-on-white, tiny-font, or metadata text that overrides your AI pipeline. Detect, strip, and harden against PDF-borne indirect prompt injection.
Indirect Prompt Injection via Fetched Web Page
An AI agent fetches a URL and the page's hidden text hijacks its next action. Detect and block indirect prompt injection from web content.
Prompt Injection Hidden in Search-Result Snippets
An AI agent calls send_email or a webhook right after a web search. The fix: scan and delimit every snippet as untrusted data, and gate side-effecting tools behind a search boundary.
Prompt Injection Introduced During a Translation Round-Trip
Hidden instructions ride into your AI pipeline through a translation step — either the LLM translator executes them, or a translation API's output re-enters unscanned. Detection, scanning, and isolation fixes.
llama.cpp mmap Fails on a Network Drive
llama.cpp crashes or stalls loading a GGUF model from an NFS or SMB share. Fastest fix: add --no-mmap (and --no-direct-io if DirectIO is on), or copy the model to local disk.
llama.cpp Quality Drops After Switching to a More Aggressive Quant
Responses degrade after moving from Q5_K_M or Q8_0 to Q4_0, IQ4_XS, or lower in llama.cpp. Pick the right quant tier, fix bad re-quants, and confirm with perplexity.
LM Studio Out of Memory When Loading a Model
LM Studio crashes or shows out of memory loading a GGUF. Fix it fast by cutting context length, enabling Flash Attention, and tuning GPU offload — with a VRAM sizing table.
Local Embedding Server Crashes Under Batched Requests
Ollama, llama-server, vLLM, or sentence-transformers crashes or OOMs on batched embeddings. Fix batch size, num_batch, sequence length, and concurrency — with the exact flags.
Chat-Template Mismatch Produces Garbage Local LLM Output
A local LLM echoes your prompt, prints literal [INST] or <|im_start|> tags, or loops the same sentence. That is a chat-template mismatch. Find the model's real template and force the engine to use it.
Multi-GPU Not Used — Local LLM Runs Only on GPU 0
Your local LLM uses one GPU while the others sit at 0%. Fix it with llama.cpp --split-mode, vLLM --tensor-parallel-size, Ollama auto-spread, and the NCCL flags PCIe rigs need.
Local LLM Output Truncated Mid-Token (Ollama / llama.cpp)
Your local model stops mid-word with no EOS token. Diagnose num_predict limits, the VRAM-based num_ctx default, stop sequences, proxy buffering, and UTF-8 byte splits.
Misconfigured RoPE Scaling Garbles Long-Context Output
A local LLM stays coherent up to its native context length, then degenerates into repetition or gibberish. Diagnose and fix RoPE scaling (YaRN, llama3, rope_theta) in llama.cpp and vLLM.
Local LLM Very Slow on First Token After Cold Start
Local LLM takes 30-120s to produce the first token after loading, then runs fast. Diagnose disk I/O, model eviction, CUDA/Metal shader JIT, and KV cache allocation, and pin the model warm.
Tokenizer Drift: Local LLM Token Counts Don't Match
Your app's token count disagrees with the local llama.cpp or Ollama server, causing context overflow or silent truncation. Use the server's own tokenizer as ground truth to fix the drift.
Local Model Ignores the Tool-Calling Format
Local LLM writes tool names in prose instead of structured JSON, or ignores the tools list. Fix it with the right tool-capable model, --jinja in llama-server, and Ollama's format JSON-schema constraint.
Local RAG Index Rebuild Is Unbearably Slow
Rebuilding a local vector index from thousands of documents takes hours instead of minutes. Fix batch size, skip unchanged docs, batch-write the vectorstore, and right-size chunks.
Compromised MCP Server: Detect and Contain a Supply-Chain Attack
A trusted MCP package ships a malicious update that steals keys or makes unexpected tool calls. Detect the compromise, contain it, rotate secrets, and harden the install with version pinning and a release-age cooldown.
mlx_lm.convert Fails Converting a HuggingFace Model
mlx_lm.convert errors when converting a HuggingFace model to MLX on Apple Silicon: Model type not supported, GatedRepoError 401, or OOM. Fixes verified June 2026.
Multi-Turn Jailbreak Escalates Over Many Messages (Crescendo)
An attacker shifts model behavior one message at a time until restrictions fall. Detect the escalation pattern across the conversation, reset context, and add session-level monitoring that fires before the violation turn.
Ollama Doesn't Detect the GPU, Falls Back to CPU
Ollama ignores your NVIDIA or AMD GPU and runs on CPU only. Read the inference-compute log line, fix driver, CUDA, and ROCm mismatches, and force GPU offloading.
Ollama Pull Stalls or Resets Mid-Download — Fixes
ollama pull freezes at a percentage, the bar runs backwards, or you see max retries exceeded: EOF. Diagnose network, disk, and partial-blob causes and resume cleanly.
Ollama Pull Succeeds but the Model Isn't in ollama list
ollama pull finishes with no error but the model is missing from ollama list. Fix the OLLAMA_MODELS path split, the ollama service-user mismatch, and corrupted manifests.
Ollama Modelfile SYSTEM Prompt Is Ignored
Your Ollama Modelfile SYSTEM directive has no effect on model behavior. Fix it fast: verify the template injects .System, check for RENDERER/PARSER inheritance, and stop your client from overriding the system message.
Fix Ollama port already in use (11434)
Ollama won't start because port 11434 is already bound. Find the process holding it, free the port, or move Ollama to another port — exact commands for macOS, Linux, and Windows.
Two Parallel Agents Edit the Same File (Lost Edits Fix)
Parallel AI agents silently overwrite each other's edits to a shared file. The fastest fix in June 2026 is worktree isolation. Here's how to detect, fix, and prevent lost writes.
Prompt Injection Bypasses Your System Prompt
A crafted user message overrides the system-prompt policy and the model ignores its guardrails. Diagnose which bypass bucket you are in, then build a layered defense that holds.
Instructions Hidden in Code Comments Steered the AI
A code comment told your AI reviewer to approve a PR or skip a section, and it obeyed. How to detect comment injection, label code as data, and shrink the blast radius.
Prompt Injection Hidden in a Filename
An uploaded file's name carries AI override instructions that fire when the agent reads the filename. The fix: reference files by UUID in prompts, never the raw name. Detect, sanitize, and block filename-borne injection.
Prompt Injection via User-Pasted Content
User-pasted text smuggles override instructions that hijack your AI assistant. Detect the trust-boundary break and harden your app so pasted content can't act as instruction.
Secret Accidentally Included in Prompt Context
An API key, password, or token ended up inside a prompt. How to rotate it fast, trace where it traveled, and stop secrets from entering the model context again.
Role-Confusion Jailbreak: User Talks Its Way to System Authority
A user convinces your AI it now has system-level authority. Spot role confusion in logs and stop it with structural trust-tier enforcement, not better wording.
Tool Output Treated as Trusted User Input
An agent runs a tool, the result contains hidden instructions, and the model obeys them. Why tool output gets user-level trust, and the role, labeling, and capability-gate fixes that stop it.
Malicious MCP Server Redefines a Tool's Behavior
A rogue MCP server hides instructions in a tool's description so the model exfiltrates data while running a normal tool. Detect, audit, and harden against tool poisoning.
User Input Treated as a System Instruction
User-typed text lands in the system/developer role or operator-trust position, so the model obeys it like a developer directive. Root causes and the architectural fix, verified June 2026.
Fix vLLM context length exceeded errors
vLLM rejects a request with This model's maximum context length is X tokens. Set max-model-len realistically, raise GPU memory, use fp8 KV cache, and budget output tokens.
Fix vLLM CUDA Version Mismatch and undefined symbol Errors
vLLM crashes on startup with undefined symbol, no kernel image, or CUDA mismatch. Install into a clean env with uv --torch-backend=auto and align driver, CUDA, and PyTorch.
ads.txt Redirect Breaks AdSense Verification
Browsers load your ads.txt fine but AdSense says it's missing. The crawler follows only one off-domain redirect and needs a final HTTP 200 in plain text. Here's how to fix the chain.
AdSense RPM Dropped After Site Redesign
Shipped a new template and page RPM fell 30-60%? It is almost always lost ad units, a viewability regression, or slots pushed below the fold. Diagnose by URL group, fix the biggest bucket first.
AI Added a Route That Bypasses Auth Middleware
AI registered an endpoint outside the authenticated route group, leaking internal data. The fastest fix: move the route under the authed router and enforce auth at the data layer, not in middleware.
AI Image Background Color Bleeds onto Subject: How to Isolate It
Subject skin and clothes pick up the wall color. Cause is cross-attention bleed and no mask. Fix fast with masked inpaint, BREAK, regional prompting, or a two-stage gen.
AI Image JPEG Edge Artifacts and Banding: 5 Steps to a Clean Export
Blocky 8x8 edges and gradient banding after an SDXL render or inpaint. Real causes are the fp16 VAE plus a lossy export. Fix with the fp16-fix VAE and PNG.
AI Image Eyes Misaligned: 5 Causes and the Two-Pass Eye Fix
One eye sits higher, the irises point different ways, or one pupil is bigger. Root cause: the eye region has too few latent pixels. Fix it with a face pass plus a dedicated eye-detailer pass.
AI Image Hair Looks Like Wires or Plastic Threads (Fix)
Generated portraits with hair that reads as stiff wire, fishing line, or melted plastic. Why diffusion models default to wire-hair, and the exact prompt, CFG, sampler, and inpaint settings that bring soft fiber texture back.
AI Image Glasses Reflections Don't Match the Scene
Generated portrait with glasses shows a window, sky, or environment in the lenses that isn't in the scene. Why diffusion models hallucinate reflections and the fastest fix, verified June 2026.
AI Image Inpaint Changes Pixels Outside the Mask
You masked one region for inpaint and pixels outside the mask shifted too. Force a paste-back composite (apply_overlay), use a hard mask, and verify with a pixel diff.
AI Image Negative Prompt Ignored: How to Fix It
Listed 'text, watermark, extra fingers' in the negative prompt and got all three anyway? It is usually one of seven causes: not wired up, CFG too low, contradicted by the positive prompt, truncated past 75 tokens, wrong weight syntax, an overtrained checkpoint, or a Flux model that ignores negatives by design.
AI Photo Has No Film Grain: 5 Fixes for a Real Analog Look
Your photo prompt outputs CG-clean, grain-free images. Cause is the model's smooth-render bias. Fix with a named film stock, weighted grain, and grain-safe upscaling or post.
AI Image Attribute Bleeding: When the Red Hat Turns the Car Red Too
A color or material from one subject leaks onto another. Cause is cross-attention bleed across CLIP tokens. Fix with weighting, BREAK, regional prompts, ControlNet, or natural-language phrasing on Flux.
AI Image Reference Image Ignored: Fix img2img & Style Transfer
Uploaded a reference for img2img, IP-Adapter, Flux Redux, or ControlNet and the output barely resembles it? Diagnose by strength sweep, confirm the reference reached the model, then crank the right knob.
AI Image Seed Not Reproducible Across Runs
Same seed and prompt, different image? Seed is only one of ~10 variables. Pin model version, sampler, scheduler, steps, CFG, and post-processing — not just the seed.
AI Image Shadows Going the Wrong Way: 5 Causes and the Fix
Shadows oppose your stated light source or two lights fight each other. The model is averaging lighting cues. Fix it with explicit direction, a reference image, and IC-Light relighting.
AI Image Skin Too Smooth and Plastic: Fix the Texture
Skin looks airbrushed, plastic, or CGI. Lower face-restore strength (visibility, not weight), prompt for pores and grain, and use a realism LoRA. Tool-by-tool fixes for SD, Flux, and Midjourney.
AI Image Text Comes Out Garbled or Wrong Language: 5 Fixes
Your sign reads OPEM instead of OPEN, or Chinese turns into fake glyphs. Switch to a text-capable model (GPT Image 2, Nano Banana Pro, Ideogram 4, FLUX.2), keep text short and quoted, or add text in post.
AI Invented a Wrong API Signature That Does Not Exist
AI calls a method that does not exist: wrong arg order, made-up option name, fabricated return type. Diagnose against the real .d.ts and ground future answers in current docs.
AI Migration Works on Dev, Fails on Prod Schema: The Fix
An AI-written migration runs clean on an empty dev DB but blows up on prod with constraint, lock, or NULL errors. Fix it with prod-clone testing and safe SQL patterns.
AI Music Tempo Drifts Mid-Track Without Edit
Suno or Udio starts at 120 BPM and wanders to 128 or 115 by the end. Fastest fix: open the song in Suno Studio and switch Project Tempo from Follow Track to Manual BPM. Plus prompt fixes that stop drift at the source.
AI-Generated SQL Locks a Hot Table for Minutes
AI wrote an UPDATE or DELETE that holds long locks on a production Postgres table and blocks reads and writes. Cancel it, then rewrite it into lock-friendly batches.
AI Keeps Using Deprecated Syntax Despite Lint Errors
AI generates code with deprecated APIs, fixes one lint error, then re-introduces it in the next file. Pin the ban in .cursor/rules and make ESLint a hard CI error.
AI Video Audio Out of Sync With Visuals: Fix
Lips move, drums hit, but audio drifts ahead of or behind the picture. Fix with a one-command ffmpeg offset, a VFR-to-CFR conform, or a one-pass synced-audio model.
AI Video Camera Motion Goes Wrong Direction
You asked for a slow dolly-in and got a dolly-out, or pan left came back as pan right. Fix it with start/end framing, screen-space language, and the built-in camera sliders in Runway, Kling, and Flow.
AI Video Extend Loses Style, Color, or Character
Extending a Runway Gen-4.5, Kling 3.0, or Pika 2.5 clip drifts in style, color, or character. Fix it with a reference image for style lock, image-to-video from a clean frame, or crossfade stitching.
AI Video: Hands Disappear or Morph During Motion
A character's hands vanish, fuse into the torso, or grow a sixth finger the moment they move. Why hands are AI video's worst region and how to keep them intact — verified across Sora 2, Veo 3.1, Kling, and Runway, June 2026.
AI Video Output FPS Doesn't Match What You Requested
Asked for 24fps cinematic, got 30fps? 60fps slow-mo judders everywhere but the model preview? Find which stage flipped the rate with ffprobe and lock it end-to-end.
Fix an AI Video Loop That Has a Visible Seam
Your AI clip jumps when it wraps. Fix it with a native loop toggle (Luma Loop tickbox, Pika auto-loop), a same-image start/end keyframe, a post crossfade, or the palindrome trick.
AI Video Multi-Character Identities Swapped Mid-Clip Fix
Two characters swap faces or clothes partway through a clip. Fix with per-character reference tags (Runway Gen-4, Kling Elements), single-character composite, or both-in-first-frame image-to-video.
Fix AI Video Prompt Keyword Ignored Mid-Clip
Prompt says rain throughout but it fades after 2 seconds. Cause is temporal prompt decay. Fix with timestamped Veo 3.1 prompts, Sora 2 storyboards, shorter chained clips, or first-frame anchoring.
AI Video Resolution Drops to 720p After Export: Fix
Generated at 1080p but the file on disk is 720p, 540p, or 480p. Fix by using the in-app HD download, checking your plan's export cap, and upscaling with Topaz, Runway, or DaVinci Resolve.
Fix Garbled or Jittery Text in AI Video
On-screen text in your AI video is misspelled, jittering, or illegible. Fix it fast: add text in post (CapCut, Premiere, Resolve) or regenerate on Veo 3.1, Sora 2, or Kling 3.0.
Remove the Watermark From an AI Video Export
Your finished clip ships with a Runway, Kling, Pika, Sora, or Veo watermark. Fix it by setting the right plan tier, flipping the export toggle, re-rendering, or matting it out in post.
AI Runs npm in a pnpm or Yarn Project (Lockfile Fix)
AI runs npm install and drops package-lock.json into a pnpm-only repo, breaking the lockfile invariant. Pin the manager with devEngines/corepack and a preinstall guard.
App Rejected for Guideline 5.1.1 Privacy: How to Resubmit
Apple cites Guideline 5.1.1 when your privacy policy, App Privacy label, or consent flow does not match what the binary does at runtime. Diagnose the six causes and resubmit.
Fix ITMS-90426 Invalid Swift Support on App Store Upload
App Store Connect rejects your IPA with ITMS-90426 Invalid Swift Support when the SwiftSupport folder is missing. The fast fix plus six root causes, diagnosis commands, and a clean rebuild.
Astro Adapter Mismatch Between SSR and SSG Modes
Astro deploy fails or pages render blank because the adapter and output mode don't match, or a route's prerender flag silently overrides the global mode. Diagnose and fix it (Astro 5/6, June 2026).
ATT Prompt Never Appears: Diagnose and Fix
ATTrackingManager.requestTrackingAuthorization returns notDetermined or denied with no dialog because of app state, the device toggle, Info.plist, or call site. Verified fixes for June 2026.
Scheduled Cron Job Skipped Silently With No Error Logged
A scheduled job never fired and nothing showed up in logs. Fix it by going UTC-only, checking startingDeadlineSeconds, adding a heartbeat, and alerting on missed runs.
Postgres Migration Stuck on ALTER TABLE in Production
An ALTER TABLE migration hangs forever on prod. Find the blocker with pg_blocking_pids, terminate it, and re-run with a lock_timeout so it fails fast instead of stalling.
Docker Container Restarts With Exit Code 137 (OOM Killed): Fix It
Container exits 137 with no stack trace. That's SIGKILL from the OOM killer hitting your --memory cap. Confirm it, find the leak with a heap dump, set a sane limit, and add a guardrail.
Fix gRPC DEADLINE_EXCEEDED Errors Under Load
gRPC clients throw DEADLINE_EXCEEDED when traffic rises. Propagate deadlines, set per-RPC timeouts by SLO, add the built-in retry policy with throttling, and trip a circuit breaker so one slow backend stops cascading.
JWT 'jwt expired' on Fresh Tokens: Fix Clock Skew
JWT verify fails with 'jwt expired' or 'token not yet valid' on tokens issued seconds ago. Fix server clock drift with NTP and add 5s verifier leeway.
Kafka Consumer Lag Keeps Growing After Scaling Consumers
You added more consumer pods and lag is still climbing. The bottleneck is almost never too few consumers. It is partition count, a poison message, a slow downstream write, or rebalance thrash.
MongoDB Aggregation With $lookup + $group Runs for 30 Seconds
A MongoDB pipeline with $lookup + $group crawls in production. Read explain('executionStats'), index the join field, push $match first, and read the new EQ_LOOKUP strategy.
RabbitMQ Consumers Connected But Not Processing — Queue Depth Growing
RabbitMQ shows healthy consumers but the queue keeps growing. Fix prefetch, unacked messages, consumer_timeout, and dead-letter routing on RabbitMQ 4.x.
Postgres Autovacuum Stalled by a Long-Running Transaction
Dead tuples climb, the table bloats, and VACUUM logs say dead but not yet removable. One forgotten transaction is pinning the xmin horizon so vacuum reclaims nothing. Find and kill it.
S3 Presigned URL Returns 403 Mid-Upload on Large Files
AWS S3 presigned URL works for small files but 403s mid-upload on large ones. Fix the TTL, the credential lifetime, and switch big files to multipart uploads.
Fix NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED in Chrome
Chrome (and now Firefox) blocks an otherwise-valid cert with NET::ERR_CERTIFICATE_TRANSPARENCY_REQUIRED. The cert was never logged to CT, or its SCTs are missing, stale, or stripped. Here is how to confirm it and fix it at the source.
ChatGPT Advanced Voice Not Available in Your Region: Fixes
Advanced Voice is gated by account country, plan tier, and app version. Most 'not available' errors trace to a stale client, a lapsed plan, or — on Mac — the desktop app's retired voice feature.
ChatGPT Attachments Lost After Refresh: Recover and Prevent
Uploaded files vanish from a ChatGPT chat after reload and you see "This file is no longer available." Recover the content, re-attach fast, and use the Library so it stops happening.
Fix ChatGPT Code Interpreter Sandbox Timeout Mid-Run
Code Interpreter kills your Python job halfway with 'execution timed out' — usually a CPU-bound loop, hung network call, or memory spike inside the ~120s, ~1GB sandbox. The fast fix: split into checkpointed cells.
ChatGPT Context Window Exceeded in Long Conversations
Long ChatGPT thread starts forgetting earlier turns. Usually the model's context window filled up, attachments are eating tokens, or you got routed to a smaller-window tier. Diagnose and fix, with exact June 2026 token limits.
ChatGPT Region-Blocked After Travel: How to Unblock It
Traveling abroad and ChatGPT shows 'not available in your country' (error=unsupported_country) or demands re-verification? Most cases clear by wiping cookies. Full fix-by-cause guide, June 2026.
ChatGPT Reads CSV But Reports Wrong Column Names or Merged Columns
Upload a CSV and ChatGPT lists weird columns, merges two into one, or treats the header as data. Delimiter and encoding detection is the usual culprit. Here is the fast fix.
Custom GPT Ownership Transfer Stuck Between ChatGPT Accounts
Built a Custom GPT on a personal Plus account and need it on a Business/Enterprise workspace? There is no per-GPT transfer button. Here is the real migration path that works as of June 2026.
ChatGPT Ignoring Custom Instructions: Fix It
Custom Instructions are saved but ChatGPT ignores them mid-chat. Usually a Project override, a Memory conflict, context overflow, or a silent model switch. Make them stick.
ChatGPT Email Change Stuck in Verification Loop
You changed your ChatGPT email, got signed out, and now neither address logs you in. The fastest fix is the 6-digit code in the new inbox (or a password reset). Recover without losing chats.
ChatGPT Silently Rejects Password-Protected PDFs
Encrypted PDF uploads succeed visually but ChatGPT answers as if the file is empty. The rejection is silent — no error banner, just hollow replies.
ChatGPT Reads Excel but Ignores Formulas (Returns Them as Strings)
Upload an XLSX and ChatGPT reports plain cell values fine, but formula-driven cells come back as the literal text '=SUM(A1:A10)' or as 0. Here is why openpyxl does this and the fastest fix as of June 2026.
ChatGPT Export Conversations Failed: Fix the Missing or Empty ZIP
Your Data Controls export never emails a ZIP, the ZIP is empty, or it downloads corrupted. Find which link in the chain broke and recover your full archive.
ChatGPT Still Uses the Old File Version After You Re-Uploaded
You replaced the file but ChatGPT keeps quoting the old text. The fix: delete the old copy, watch the Skip / Upload anyway prompt, rename to bust the cache, or open a new chat.
ChatGPT: 'No Text Could Be Extracted From This File' (Scanned / Handwritten PDF)
Scanned or handwritten PDFs return 'No text could be extracted from this file' or hallucinated content because the extractor only reads the text layer. Fastest fix: upload page images, not the PDF.
ChatGPT Treats Uploaded JSON as Plain Text Instead of Structured Data
ChatGPT read your JSON as a wall of text and string-matched an answer instead of running pandas. Here's how to force the code sandbox and get real aggregates.
ChatGPT MFA Backup Codes Lost and Authenticator Wiped
Phone wiped, authenticator gone, backup codes nowhere? Here is the June 2026 way to recover ChatGPT 2FA access without losing your account or subscription.
ChatGPT Model Auto-Switched Mid-Conversation Without Warning
You started in GPT-5.5 and answers suddenly feel shallower — the auto router quietly downgraded you, usually because of cap pressure, tool routing, or a regenerated reply.
ChatGPT Plan Downgraded Mid-Cycle With No Refund or Pro-Rate
You canceled Plus a few days into the billing cycle and lost access with no money back. Here is how to tell whether that is policy, an app-store issue, or a real bug — and how to claim a refund if you qualify.
Renaming a ChatGPT Project Breaks Its Share Link
You rename a ChatGPT Project and the old share link 404s, shows a stale snapshot, or throws an access error. Here's why, and the exact fix that works as of June 2026.
ChatGPT Project Says 'I Don't See That File' When It Clearly Has It
Files are in your ChatGPT Project but vector search misses them on short queries. Fastest fix: name the exact filename in your prompt to force keyword retrieval.
ChatGPT Shared Project Not Showing in Sidebar (Team/Business)
A shared ChatGPT Business or Enterprise Project isn't in your sidebar. Usually you joined after it was shared, you're on the wrong workspace, or the Pinned section is collapsed. Find it and fix it.
ChatGPT Response Cut Off Mid-Sentence: Why It Stops and the Fastest Fix
ChatGPT stopping mid-output is usually the response length budget, a structural stop the model chose, or a dropped stream. Type continue first, then fix the real cause.
ChatGPT Scheduled Tasks Not Firing at the Set Time
Your ChatGPT Task should have run at 9am but the inbox is empty. Account timezone drift, an auto-paused Task, or a lapsed Plus plan are the usual causes — here is the fix order.
ChatGPT Truncates a Large CSV to the First 1000 Rows
Upload a big spreadsheet, ask 'how many rows are there,' and ChatGPT says 1000 — that's sampling, not counting. Here's how to force a full-file analysis on every row.
ChatGPT Streaming Stops Mid-Word: Recover the Reply
The reply streams half a sentence then freezes. Usually a dropped SSE connection, a backgrounded tab, or a backend hiccup. Refresh first, then diagnose by bucket.
ChatGPT Team (Business) Invite Link Expired or Invalid
Your ChatGPT Team/Business invite shows 'expired' or 'invalid'. Usually a 7-day TTL, an email mismatch, the wrong active workspace, or a domain rule. Fix it without buying a new seat.
ChatGPT VAT Invoice Missing or Wrong (EU and UK Fix)
Your ChatGPT invoice has no VAT line, no VAT number, or the wrong country rate. Here is the exact billing screen to fix it and get a compliant invoice your accountant accepts.
ChatGPT Won't Read Inside an Uploaded ZIP Archive
Upload a ZIP and ChatGPT sees only the filename, never the contents. The fix: trigger Data Analysis with an explicit unzip prompt, or extract locally and upload the files. Verified June 2026.
Claude Artifact React Component Fails Silently on Prop Errors
Your Claude React artifact renders a blank Preview with no error banner. The fastest fix: open DevTools console (or click 'Try fixing with Claude') to read the swallowed exception. Full cause-by-cause debug guide.
Claude Artifact Reverts to an Old Version After a Follow-up
You hand-edit an artifact, send one more message, and it snaps back to a version from three turns ago. The fix: your in-panel edits never reached Claude's memory. Recover them from the versions dropdown and stop it recurring.
Claude Attachment Preview Not Rendering: Fix the Blank Thumbnail
Claude shows the attachment tile but no preview thumbnail. Usually a render lag, an unsupported format (HEIC/TIFF), or a stale cache. Fastest fix and full diagnosis here.
Claude Web Search Citations Return 404 or Wrong Page
A Claude citation link 404s or lands on the wrong article. Usually URL reshaping, an expired snapshot, or a paywall — how to rescue the real source and verify the fact.
Claude Code Bash Sandbox Blocks an Expected Command
Claude Code keeps prompting for a command you allowlisted. Fix it: prefix patterns with a trailing wildcard, split compound commands, and check the new OS sandbox fallback. Verified June 2026.
Claude Code Not Loading Your Project CLAUDE.md (2026 Fix)
Claude Code starts a session but ignores your project CLAUDE.md. Run /memory to see what loaded, fix the path/casing, and resolve the cause in minutes.
Claude Code Hook Blocks Edit Unexpectedly
A PreToolUse hook keeps rejecting Edit calls, even safe ones. The fix is almost always exit-code 2 logic, the deny-JSON format, stdin parsing, or matcher scope.
Claude Code MCP Call Times Out (or Hangs) Repeatedly
MCP tool calls in Claude Code time out or hang while a direct curl works. Usually stdio stdout pollution, the wrong startup vs tool timeout, a never-sent initialize, or a proxy that buffers SSE. Fixes verified June 2026.
Claude Code Output Truncated by Context Window
A long Claude Code reply cuts off mid-sentence. Fastest fix: tell it to continue from the last line. Real cause is usually auto-compact, the per-reply output cap, or one huge tool result eating the budget.
Claude Code Session Resume Loses Memory of Prior Work
Resume a Claude Code session and it acts like a fresh start — forgetting the plan, the decisions, the half-finished refactor. Diagnose compaction, broken transcript chains, and ephemeral tool results, then fix it.
Claude Code settings.json Not Loading After Edit
Edited ~/.claude/settings.json but Claude Code ignores your hook, permission, or env? Run /doctor first. Usually JSON syntax, wrong scope, or precedence shadowing.
Claude Code Skill Not Discovered or Auto-Triggered
You added a SKILL.md under ~/.claude/skills/ but /<name> says not found, or it never auto-fires. Fix the path, frontmatter, description, or skill-budget issue in minutes.
Claude Code Statusline Script Errors, Blank, or Hangs
Your Claude Code statusLine shows an error, stays blank, or stalls the prompt. Fix the JSON-on-stdin contract, missing jq, exit codes, slow git calls, and workspace trust.
Claude Code Subagent Result Not Relayed to Main Session
A Task subagent finished cleanly but the main Claude Code session shows nothing, a generic summary, or claims it's still running. Fix the final-message, output-size, or routing problem in minutes.
Claude Computer Use Stuck Clicking the Same Button in a Loop
Claude Computer Use keeps clicking the same button or field without progressing — almost always a screenshot-timing, coordinate-scaling, or hidden-state problem. Here is the fastest fix plus the full diagnosis.
Claude Conversation Export Broken: PDF or Data Dump Fails
Print to PDF gives a blank page, or your Settings > Privacy data export never emails a link. Usually a long thread, a failing artifact, or a stuck export job — here is the exact fix for each.
Claude Google Drive Connector Stuck in a Re-Auth Loop
Claude's Google Drive connector asks you to reauthorize after every query even though it shows 'Connected' — usually third-party cookies, a missing refresh token, or a Workspace token policy. Here is the diagnostic path.
Claude Memory Is On But No Memories Show Up
Memory is enabled but Settings shows 'No memories yet' and Claude never references past chats. The usual cause: only 'Search and reference chats' is on, not 'Generate memory from chat history'. Here is the fix.
Claude PDF Table Extraction Pulls Cells Into Wrong Columns
Claude reads a PDF but table cells land in the wrong columns, rows merge, or numbers shift one header over. Here is the fastest fix plus a cause-by-cause repair for both the source file and the prompt.
Claude Thinking Toggle On but No Reasoning Trace
You enabled extended thinking and Claude replies instantly with no visible reasoning. As of June 2026 it is usually a low effort level, an easy prompt under adaptive thinking, a collapsed trace, or plan limits. Diagnose and force thinking back on.
Cloudflare Orange Cloud vs Grey Cloud: Wrong Toggle Breaks Site
The orange/grey cloud in Cloudflare DNS decides whether traffic hits the edge or your origin. The wrong state breaks SSL issuance, WebSockets, or origin masking. Here's how to pick the right one.
Fix CLS Spike From Runtime Ad Insertion
Auto Ads or custom scripts inject slots after first paint, pushing content down and wrecking CLS. Fix by pre-rendering placeholders with reserved height.
Codex Committed to the Wrong Branch (or Straight to main)
Codex landed your work on main, on a leftover branch, or split it across two — because cloud tasks default to your repo's default branch and local worktrees collide. How to force clean per-task isolation, plus how to rescue commits that already landed wrong.
Codex Stalls on a Merge Conflict or Resolves It the Wrong Way
Codex hits conflict markers and stalls, picks the wrong side, or commits the markers into the file. Rebase in setup, an AGENTS.md stop-on-conflict rule, and a pre-commit hook fix it.
Codex Added a Package but the Lockfile Did Not Change
Codex edited package.json but never ran npm install, so package-lock.json diverges and npm ci fails. Fix it with setup.sh, a CI sync check, and AGENTS.md rules.
Codex Fix Passes Every Test but Breaks at Runtime
Codex's PR is green in CI but the app crashes after deploy. Why agent fixes that target the test surface miss the runtime, and the smoke-gate that closes the gap.
Codex Creates a Duplicate TypeScript Interface for One That Already Exists
Codex defines a fresh User or ApiResponse type when an identical one already lives in your repo. Make the agent search first using AGENTS.md, a types barrel, ripgrep, and a ts-morph CI check.
Codex Rewrote Git History You Did Not Want Touched (amend / rebase / force-push)
Codex ran git commit --amend, an interactive rebase, or force-pushed and rewrote shared history. Lock the agent to forward-only commits with AGENTS.md, the sandbox network toggle, and a GitHub ruleset.
Codex PR Description Says "Refactored Components" and Nothing Else
Codex emits a one-line PR body with no detail. Force a structured description (before/after, why, test plan) with a PR template, AGENTS.md, and a CI gate; plus the Codex Cloud button caveat.
Codex Says Tests Passed but Actually Skipped the Failures
Codex reports green tests but the failing cases were filtered out, marked .skip, or bailed early. How to force honest test reporting before merge.
Codex Stops Mid-Refactor on a Large Diff: How to Finish the Job
Codex hits a context limit mid-task and leaves a half-applied patch. Scope tasks to one verb, split into multi-PR plans, tune auto-compaction, and resume cleanly with config that works as of June 2026.
Stop Codex Writing componentWillMount and Other Deprecated APIs
Codex injects API patterns deprecated years ago because its training data lags. Lock it to modern APIs with AGENTS.md rules, the @typescript-eslint/no-deprecated lint rule, and current reference docs.
Internal Link Rot: Articles Point to Renamed or Deleted Slugs
Half your internal links 404 because you renamed slugs without redirects. Add host-level 301s, run lychee in CI, and fail prebuild on any link that points at a slug that does not resolve.
Canonical Points to the Wrong Page: Translations Canonicalize Back to English
ZH pages carry a canonical that points at the EN version, so Google deindexes the ZH variant. Fix: self-referential per-page canonical, verify with curl + view-source.
FAQ Rich Result Gone in Google? It's Deprecated, Not Your Schema
Your FAQPage JSON-LD looks right but the FAQ rich result never shows. As of May 7 2026 Google deprecated FAQ rich results for everyone. Confirm it, then decide keep vs remove.
Hreflang Misconfigured Between EN and ZH: No Return Tags, Wrong Codes, Missing x-default
Hreflang pairs don't reciprocate, language codes don't match (zh vs zh-CN), x-default missing. Auto-emit from translationKey, validate with the Merkle hreflang tester, fix at the source.
Image Alt Text Missing in Bulk: Audit, Backfill, and Lock It In
Hundreds of images with no alt attribute hurt accessibility, image search, and AdSense quality. Audit by category, backfill by traffic, then fail the build on regressions.
Publish Date Stuck in the Past: Articles Look Stale After Real Refreshes
Your publishedAt never moves so SERP shows an old date. Add updatedAt, show ONE date, match schema to the visible date, and bump only on substantial edits.
Redirect Map Bloated to Thousands of Lines, Slowing Builds
A 3,000-line _redirects file slows builds, makes crawlers chase chains, and silently drops rules past your host's cap. How to audit, collapse chains, and prune safely.
Related-Articles Widget Keeps Surfacing Near-Duplicate Pages
Your 'Related articles' panel shows three near-identical posts on every page. Detect the leak, score 'related but not duplicate' with MMR, and stop recommending duplicates to yourself.
Tag Archive Pages With Zero Articles: Empty Pages Bloating the Sitemap
Tag pages render but have 0 published articles after a cleanup. Audit tag counts, set a minimum-per-tag prebuild rule, and 410 the empty archives so Google drops them fast.
Translation Pages Mismatched: EN Has 5 Sections, ZH Has 3
Solo edits drift EN and ZH apart — sections, code blocks, links diverge. Audit pairs by structure, diff bilingual content, and enforce translate-as-you-edit in CI.
Cursor Auto Routes a Hard Task to a Weak Model
Cursor's Auto router sends a complex refactor to a small model and you get shallow edits. Diagnose the routing signals and force the right model for hard tasks.
Cursor Chat or Composer History Missing After Restart
Cursor reopens with an empty chat list, only the latest thread, or stuck on 'Loading Chat'. Usually a workspace-hash change, a botched update migration, or a corrupted state.vscdb. How to recover and prevent it.
Cursor Cmd-K Inline Edit Spinner Never Returns: Fix It
Cmd-K (Ctrl+K) spins forever or shows "Taking longer than expected…" with no diff. The fast fix: Reload Window or update Cursor. Walk the six verified causes.
Fix Cursor Extensions: Network Error or Empty Marketplace
Cursor's Extensions panel shows a network error, empty list, or a stuck spinner. Cursor uses Open VSX, not Microsoft's marketplace. Pick the right cause and fix it fast.
Cursor MCP Server Shows Disconnected or No Tools
Added an MCP server in Cursor but it stays disconnected, or no tools appear in chat. 90% of the time it's a bad PATH, a JSON typo, or a stdout leak. Diagnose and fix in five minutes.
Cursor Python Venv Not Detected (Wrong Interpreter)
Cursor uses system Python instead of your project venv, breaking imports, linting, and agent edits. Fix the interpreter picker, venv discovery, shell PATH, and the new Python Environments panel.
Cursor Settings Sync Overwrites Local Config on Another Machine
Cursor has no native Settings Sync. When a Gist-sync extension, dotfiles symlink, or cloud folder pushes stale config to a second machine, your rules, keybindings, or MCP servers get clobbered. Diagnose which sync layer did it and recover the good version.
Cursor SSH Remote Connection Drops Mid-Edit: 6 Fixes
Cursor's SSH Remote session disconnects while you edit, losing agent context and unsaved buffers. Fix it with the right keepalive values, and check for the v1.0.51 reconnect bug.
Cursor Codebase Index Stale After Rebase or Branch Switch
After a rebase or branch switch Cursor cites files and line numbers that no longer exist. The indexer fell behind your git state. Force a re-index and harden the workflow.
Cursor Runs Shell Commands Without Asking (YOLO / Auto-Run)
Cursor Agent runs terminal commands with no confirmation even after you turned auto-run off. As of June 2026 it's almost always Run Mode, a wide allowlist, or a workspace permissions.json. Fix it in a minute.
Deploy Preview URLs Got Indexed by Google
Vercel/Netlify preview URLs showing in Google's index — usually a custom-domain preview, an indexable latest branch deploy, or a sitemap/canonical that overrides the auto noindex. Here's the fast fix.
DNSSEC SERVFAIL After Enabling at Registrar: Fix the Broken Chain
You turned on DNSSEC and validating resolvers now return SERVFAIL. Read the EDE code, regenerate the DS from the live DNSKEY, replace it at the registrar, or pull the DS to roll back. Verified June 2026.
Dynamic Title Set by JavaScript Not Indexed by Google
Your SPA sets `document.title` after render, but Google indexes the placeholder. Every SERP result shows "Loading..." or your home title. Here is the fix.
Fix ITSAppUsesNonExemptEncryption Missing Export Compliance
TestFlight asks for export compliance on every build because Info.plist does not declare ITSAppUsesNonExemptEncryption. Set it correctly and the prompt disappears.
Few-Shot Examples Have Uneven Quality and Drag Output Down
You gave the model 5 examples; 2 are great, 3 are mediocre, and it averages toward the mediocre ones. Why example variance hurts and how to curate down to 3-5 consistent ones.
Gemini Code Assist IDE Plugin Out of Sync With the Web Model
The Gemini Code Assist plugin in VS Code or JetBrains feels weaker than gemini.google.com. As of June 2026 the cause is often the Antigravity migration, a stale plugin, a wrong project binding, or a stuck index.
Gemini Connected Apps (Workspace, Maps, YouTube) Not Triggering
Gemini ignores Gmail, Maps, or YouTube and answers generically. As of June 2026 these are 'Connected Apps,' @Maps/@YouTube were removed, and a few toggles must line up. Fast fixes inside.
Gemini Gems Not Saving or Disappearing: Fixes
Gem won't save, shows 'Sorry, we can't save your gem', or knowledge files vanish? Most causes are the Save vs Update button, a stale session, special characters, or a Workspace block. Fix in five minutes.
Gmail 'Help Me Write' Drafts Sound Off-Tone or Generic in Gemini
Gemini's Help me write in Gmail keeps handing back a stiff corporate email that ignores the thread. Usually it is missing thread context, the smart-features toggle is off, or the prompt is too thin. Fixes that work as of June 2026.
Gemini Image Generation Blocks a Reasonable Prompt as a Safety Violation
Gemini (Nano Banana) or Imagen rejects a normal prompt as a 'violation.' Usually named people, brands, or aggressive default safety. Exact rewrites and API fixes here.
Gemini 1M Context Still Truncates Long Documents
Gemini 3.1 Pro promises 1M tokens but your long doc gets cut off mid-answer. It is almost always the 8K output cap, not input. Fixes inside (as of June 2026).
Gemini PDF Citations Missing or Wrong Page Numbers
Asked Gemini for page-numbered PDF citations and got vague refs, wrong pages, or invented numbers? It's almost always OCR quality, weak prompting, or the wrong surface. Verified fixes for June 2026.
Gemini 3.1 Pro Thinking Stops Mid-Reasoning: Fix
Gemini 3.1 Pro Thinking truncates mid-thought or returns a short answer with no reasoning. Usually it's thinking level vs output cap. Verified fixes for June 2026.
Gemini Video Upload Rejected or File Type Not Supported
MP4 or MOV upload to Gemini fails with 'file type not supported' or silent rejection. As of June 2026 the real cap is video length, not size. Fix paths inside.
Gemini Voice Mode Cuts Off or Doesn't Hear You
Gemini voice cuts off mid-reply or can't hear you. Fastest fix: update the app (the March 2026 redesign stopped pause-cutoff), grant mic, restart Live. Full diagnosis inside.
GitHub Actions Deploy Step Hangs Until the 6-Hour Job Limit
Your GitHub Actions deploy step hangs and gets cancelled at the 360-minute job limit. The fastest fix is a shell timeout wrapper plus non-interactive deploy flags. Full diagnosis and fixes inside.
HowTo Schema Is Deprecated But Your Template Still Emits It
Google retired HowTo rich results in 2023. The Schema Markup Validator still passes your HowTo JSON-LD, so it looks fine — but Google's Rich Results Test no longer detects it and the result never returns. Here's how to confirm and clean it up.
Hreflang "No Return Tags": Fix the Missing Reciprocal Link
A crawler flags "missing return tags" on your hreflang cluster: page A points to B, but B doesn't point back to A. Make every reference reciprocal so Google stops ignoring the whole set.
HSTS Preload Stuck: How to Roll Back HTTPS Enforcement
You preloaded your domain, then needed HTTP back. Browsers still force HTTPS. Here's the fastest real fix, the exact removal steps, and the honest timeline.
IPv6 Users Can't Reach Site: AAAA Record Missing or Broken
IPv4 users reach the site fine but IPv6 users get timeouts. Either AAAA is absent, points to a dead address, or your firewall blocks v6. Fix dual-stack.
JavaScript-Rendered Content Not Showing in Google Index
Your SPA renders fine for users, but Search Console shows the page indexed with an empty body. Why Googlebot's render pass loses your content, and the fastest fix.
Model Returns Invalid JSON Because Schema Was Described, Not Enforced
You asked for JSON matching a schema. Most calls return valid JSON, some return prose with JSON inside, some omit fields. Description vs enforcement, and how to fix at the API layer.
App Crashes on Launch: Missing NSXxxUsageDescription Fix
iOS kills the app the instant a privacy-protected API runs without a matching Info.plist usage description. Read the exact missing key from the device console, add it, confirm it survives the archive, and ship.
Indexing Dropped After Google Switched Your Site to Mobile-First
Search Console confirms mobile-first indexing, then two weeks later valid pages and impressions fall 15-40%. The cause is almost always content the mobile HTML is missing. Here's how to diagnose and close the gap.
Model Invented Fake Citations and URLs
The model produced a citation like Smith et al. 2019 and the paper does not exist, or a URL that 404s. Why citation hallucination happens and how to stop it for good.
Model Replies in the Wrong Language (How to Lock It)
You prompted in English and the model answered in Chinese, or it switched mid-output. The exact cause of language drift and the system-prompt + retry pattern that locks the output language, verified June 2026.
Monorepo Deploy Only Ships One App Out of Several
Your monorepo has three deployable apps but Vercel only deploys one. Fix the per-project Root Directory, the Skip-deployment toggle, and the Turborepo filter scope — with exact menu paths as of June 2026.
Netlify Function Times Out at 10s on Cold Start
A Netlify Function works locally but the first request after idle returns 502 with 'Task timed out after 10.00 seconds'. Fastest fix: lazy-import heavy SDKs and remove aws-sdk v2 so cold-start init fits the 10s sync limit.
Next.js ISR Revalidation Stuck on Stale Pages (Vercel, 2026)
An ISR page keeps serving old HTML past its revalidate window. Read the x-vercel-cache header, force an on-demand revalidate, and fix the real cause: edge shadowing, a failing background render, or a path mismatch.
Subdomain NS Delegation Fails: Missing Glue Records
Delegated a subdomain to nameservers inside itself and resolution fails? The parent zone needs glue A/AAAA. Here is the dig diagnosis and the exact registrar fix.
LLM Response Cut Off Mid-Sentence: max_tokens Too Low (2026 Fix)
The model's reply ends mid-sentence, mid-JSON, or with an unclosed code block. It is almost always the token cap. How to size it, detect truncation per SDK, and recover.
noindex,follow on Page 2+ Is Orphaning Your Deep Articles
An old SEO tip says put `noindex,follow` on paginated pages. Google treats long-term noindex,follow as noindex,nofollow, so articles reachable only via page 2+ quietly drop out of the index. Here is the fix.
Product Schema Review Count Does Not Match Visible Reviews
JSON-LD asserts 1,247 reviews at 4.8 stars but the page only shows 32. Google logs a review mismatch and your star chip drops from SERPs. Fix: make reviewCount equal the visible count, from the same source.
Prompt Asks for 10 Items, Model Returns 3 and Stops
You asked for 10 ideas and got 3, or 10 slots padded with filler. Why list-length prompts under-deliver, and the prompt + schema fixes that actually get you N distinct items.
Prompt Has a Stale Year That Anchors the Model to Wrong Context
Your prompt still says 2023 in 2026, so the model recommends GPT-4, quotes old pricing, and cites dead frameworks. Fastest fix: inject the current date dynamically. Plus a diagnosis table and how to confirm it's gone.
Query-Parameter URLs Creating Duplicate Index Entries
Search Console reports thousands of duplicate URLs with `?utm_*`, `?sort=`, `?ref=` variants. Consolidate them with rel=canonical and clean internal links.
robots.txt Blocks CSS/JS and Indexing Quality Drops
You disallowed `/assets/` or `/_next/static/` to "save crawl budget," so Googlebot can't render the page. Fastest fix: stop blocking render resources and re-test in URL Inspection.
Fix Article Schema Missing Field author.name in Search Console
Search Console warns "Missing field author.name" on Article pages. The byline string is set, but the JSON-LD shape is wrong. Here is the exact fix, the minimum valid shape, and how to verify it.
App Store iPad Pro Screenshot Wrong Dimensions — Fix
App Store Connect rejects iPad Pro screenshots with Invalid Screenshot Dimensions. As of 2026 the 13-inch 2064x2752 slot is required. Reference matrix, sips fixes, FAQ.
Service Worker Serves Stale Bundle After Deploy
Users still see the old site after you deploy because a service worker keeps serving the cached bundle. Fix it with NetworkFirst HTML, skipWaiting + clientsClaim, a no-cache sw.js, and a same-URL self-destruct kill switch for trapped users.
Sitemap Over 50,000 URLs: Split It With a Sitemap Index
A single sitemap.xml caps at 50,000 URLs and 50 MB uncompressed. Search Console says "Couldn't fetch" or only reads the first 50,000. How to split correctly and resubmit.
Sitemap lastmod Is Always Today and Google Stopped Trusting It
Every URL in your sitemap reports today's `lastmod`. Googlebot crawl rate falls instead of rising, because Google now ignores the field as unreliable.
SSL Cert Auto-Renewal Failed Silently, Site Now Untrusted
Certbot renewal stopped months ago and you only noticed when the browser flashed NET::ERR_CERT_DATE_INVALID. Diagnose the real cause and restore HTTPS in under an hour.
Suno Bridge Missing — Verse-Chorus-Out Fix
Your Suno song goes verse-chorus-verse-chorus-outro with no bridge. 4 fixes to force a bridge section using `[Bridge]` tag and Custom Mode.
Suno Chorus Too Loud: Tame the Volume Jump
Verses sit at a comfortable level then the chorus blasts +6 to +10 dB louder. Why Suno (v5.5, June 2026) does this and how to regenerate, remix, or compress the dynamics back to a usable balance.
Suno Cover Upload Rejected — Copyright or Quality Fix
Suno rejects your cover upload with 'copyright detected' or 'audio quality insufficient'. 5 fixes covering clean sources, SNR, and licensing toggles.
Suno MP3 Export Quality Low Even on Pro Tier Fix
Suno MP3 sounds compressed even on Pro. Caused by lossy pipeline. 5 fixes via WAV/FLAC export, 320kbps re-encode, tier checks.
Suno Intro Too Long — 30s Before Vocals Fix
Suno keeps building a 30-second instrumental intro before the vocal lands — caused by 'epic' style words. 5 fixes to get vocals from 0:00.
Suno Lyrics Out of Sync With Melody Fix
Lyrics lag the beat or words run together — caused by syllable count mismatch. 5 fixes for clean lyric-to-melody alignment.
Suno Mastering Too Loud, Clipping on Peaks Fix
Suno output clips on peaks and distorts at high volume. Caused by Suno's loudness war default. 5 fixes via Audacity, iZotope Ozone, target -14 LUFS.
Suno Personas Not Applied — Vocal Doesn't Match Fix
You selected a Persona but the vocal sounds nothing like the original. Caused by tier limits, weak training clip, or wrong mode. 5 fixes.
Suno Vocal Gender Wrong — Asked Female, Got Male Fix
You wrote 'female vocal' but Suno keeps shipping a baritone — style words like 'deep, gritty, rock' override the gender tag. Fix in 4 steps.
Suno WAV Export Sample Rate Mismatch: Fix 44.1 vs 48 kHz
Your DAW or video editor flags a sample rate mismatch on a Suno WAV. Confirm the real rate with ffprobe, convert losslessly with SoX/ffmpeg, and stop silent resampling.
Title Tag and H1 Mismatch Causes Google Rewrites
Your `<title>` and `<h1>` say different things, so Google trusts neither and rewrites your SERP title. Align them and re-request indexing to get your title back.
Vercel Build Exceeds 45-Minute Limit and Gets Cancelled
Your Vercel build runs to 45 minutes and dies with 'Build step did not complete within the maximum of 45 minutes' — usually a cold cache, unbounded page generation, or a hung post-build step. Here's how to find which one.
Voice Clone Has Unnatural Breathing and Pauses
Your AI voice clone says the words but breathes in the wrong place, pauses mid-clause, or never breathes at all. Fastest fix: re-punctuate the script and match pause control to your model (audio tags for Eleven v3, SSML for v2).
AI Image Batch Style Drift: Lock Style Across a Batch
Generate 20 campaign images and they look like 20 different photographers shot them? Here is the June-2026 workflow to lock style across a batch: sref, Omni Reference, Flux Redux, LoRA, and palette enforcement.
Fix AI Image Hands With Extra Fingers
Six fingers, fused thumbs, backward knuckles. The working fix path: hide hands when you can, raise pixel budget when you cannot, then run a hand-specific inpaint pass. Updated for June 2026 tools.
Fix AI Product Shape Distortion in Hero Shots
AI hero shots warp the bottle, bend the box, melt the logo. The working fix: lock the silhouette with ControlNet from a real product photo, or composite the real product onto the AI background.
AI Image Symmetric Pose Broken: Mirror-Fix Workflow
Symmetric poses come out lopsided — one shoulder higher, one eye off-center, hands at different heights. The fix: ControlNet OpenPose, inpaint the broken half, or mirror-composite for pixel-perfect symmetry.
AI Image Text Comes Out Garbled: The 2026 Fix
AI poster headlines render as letter soup. Fastest fix as of June 2026: switch to a typography-grade model (Ideogram 3.0, GPT Image 2, Nano Banana 2), quote your exact words, then composite real type only if needed.
AI Video Aspect Crop Wrong on Export
Subject's head is cut off or composition breaks on export to 9:16 / 1:1 / 16:9. Fix by generating natively at the target ratio, using Premiere Auto Reframe or DaVinci Smart Reframe to track the subject, or padding with smart bars.
AI Video Camera Jitter and Unwanted Pan Fix
Camera drifts, jitters, or pans when you wanted a locked shot. Fix it by enabling Static Camera, stripping cinematic verbs, zeroing motion sliders, and stabilizing in post.
AI Video Frame Flicker Fix (Runway, Kling, Pika)
Generated clip flickers frame-to-frame in lighting, texture, or color. Fix by pinning lighting, lowering image-to-video creativity, cleaning the reference, and using a current model (Runway Gen-4.5, Kling 3.0, Pika 2.5). Verified June 2026.
Fix AI Talking-Head Lip-Sync Drift
Lips lead or trail the audio in AI talking-head clips. Fix it by isolating clean 44.1 kHz vocals, switching to a language-agnostic model (sync. lipsync-2, HeyGen Avatar IV), and aligning offset in Resolve.
GraphQL Rate Limit Cascade: Stop One Slow Resolver Taking Down the Gateway
One slow resolver hits an upstream 429 and the whole GraphQL gateway stalls. Fix it with per-query complexity costs, DataLoader batching, fail-fast circuit breakers, and per-upstream connection pools.
Message Queue Dead-Letter Queue Building Up
DLQ growing in SQS, RabbitMQ, or Kafka without bound. Sample and classify the failures, fix the poison-message root cause, cap the retry budget, then redrive safe messages.
Postgres Connection Pool Exhausted Under Load
Postgres throws 'remaining connection slots reserved' under traffic. Fix it by sizing the pool, putting PgBouncer in transaction mode in front, and killing idle-in-transaction connections.
Redis Cluster Failover Stuck: No Replica Gets Promoted
A master node died but no replica took over and the cluster sits in fail state. Fix it by checking master quorum, the FAIL flag, replica eligibility, and forcing a manual takeover.
ChatGPT Double-Charged After a Plan Switch: How to Fix It
Two ChatGPT charges on the same card after upgrading or switching plans — usually a web/Apple overlap or a pending auth, not a true duplicate. How to find the real one and get the other refunded.
ChatGPT Data Export Email Never Arrives
Requested a ChatGPT data export but the download link email never came — usually a spam filter, the wrong email on file, or a still-processing job. Fastest fixes inside.
ChatGPT Account Deactivated: How to Appeal and Recover
ChatGPT says your account is deactivated. Tell an age-verification lock from a policy ban first, then appeal at openai.com/form/appeal with your User ID and Org ID.
ChatGPT Enterprise SSO Login Fails After IdP Update
Okta/Azure/Google SAML breaks after a metadata or claim change. Re-paste the IdP X.509 cert at chatgpt.com/admin/identity, then check NameID and the email attribute.
ChatGPT Org / Workspace Switch Keeps Reverting
You switch ChatGPT workspace or OpenAI org, restart the browser, and land back on the old one. Fix the server-side default and the session-scoped cookie — not a bug, almost always one of five causes.
ChatGPT Phone Verification Loop on Signup
SMS code accepted, then signup asks for the number again. Fix the number-reuse, VOIP, region, and risk-trigger causes behind the loop.
ChatGPT Project File Limit Hit: How to Free Slots Fast
Plus caps Projects at 25 files (Pro/Team/Enterprise 40, Free 5). Upload greyed out? Consolidate, archive, or split the Project instead of fighting the cap.
ChatGPT Project Export Is Missing Uploaded Files
Data Export delivers a zip with conversations.json and chat.html but no PDFs or images you uploaded to Projects. Pull the binaries from the Library or each Project's Files panel instead.
ChatGPT Project Knowledge Stale After Editing a Source File
You edited the doc, but ChatGPT still quotes the old text inside the Project. Project Files are point-in-time snapshots, not live links — delete the old file, re-upload, and start a fresh chat.
ChatGPT Project Instructions Ignored After Update
Rewrote a Project's instructions, hit save, but ChatGPT still follows the old rules? It's almost always an old chat thread, a Saved Memory, or silent truncation overriding the new rule. Here's the fix order.
ChatGPT Project Share Link Returns 404 / No Permission
Your Project share link gives a teammate 404 or 'You do not have permission' — usually because they weren't invited, used the wrong account, or the link is set to 'Only those invited'. Here is the fast fix.
Claude Artifact Renders as a Blank Pane
The artifact opens but shows white. Fastest fix: open the iframe console, copy the red error, paste it back to Claude. Covers sandbox storage errors, the cdnjs allowlist, and the published-artifact origin bug.
Claude Code Keeps Asking Permission for the Same Command
Claude Code re-prompts for a Bash or Edit you already allowed. Usually the allow pattern is too narrow, lives in the wrong settings scope, or the command is compound — here is the exact fix.
Claude Code Token Budget Too Large for One Task
One task burns through the context window, auto-compacts mid-refactor, and loses your plan. Decompose into smaller steps, push reads into sub-agents, and save state to disk.
Claude Code Bash Tool Hangs: Fix Stuck Commands
A dev server or curl runs forever and Claude Code freezes on a spinner. Use run_in_background, set an explicit timeout, and kill stuck shells with /tasks. Verified June 2026.
Claude File Upload Stuck on Processing: Fix It Fast
Claude shows the spinner forever and the file never attaches. The usual culprit is a PDF over 100 pages or a browser extension breaking the upload — here is how to tell which one and fix it.
Claude Projects: Context Leaking Between Chats
A new chat in the same Claude Project answers from an earlier chat's content. Five surfaces leak differently — project knowledge, instructions, project memory, Search and reference chats, and connected sources. Diagnose which one, then fix it.
Claude Skills Not Firing When Expected
Claude answered in plain prose instead of running your Skill. Usually the SKILL.md description is too vague, the Skill isn't enabled on this surface, it has disable-model-invocation set, or it got dropped from Claude Code's skill budget. Fixes verified June 2026.
Claude Team Billing Doesn't Match Seat Count: Fix
Invoice charges 10 seats but the admin panel shows 7 members. The usual causes: pending invites bill immediately, Premium seats cost 5x Standard, and mid-cycle removals are paid but freed for reassignment. How to reconcile, as of June 2026.
Claude Tool Call Stuck on Pending: Fixes
The tool-call spinner keeps spinning — no result, no timeout, no error. Usually a missing tool_result, a pause_turn from web search, the Claude Desktop render bug, or a dropped MCP connector. Diagnose by surface and unstick.
Codex Agent Output Conflicts With Prettier
Codex writes a file, Prettier reformats it on save, and the diff explodes. Fix it by running the project's pinned Prettier inside the agent loop and aligning AGENTS.md style hints to .prettierrc.
Codex Agent Goes Out-of-Context on Long Repos
On 500k+ line repos Codex loses the thread halfway. Fix it by scoping the working set, pre-feeding directory summaries, and putting conventions in AGENTS.md so they survive compaction.
Codex Agent Silently Skips Files Containing Binary Data
Codex quietly drops PNGs, PDFs, sqlite DBs, and compiled artifacts from audits. Fix it by probing binaries (file + wc -c + sha256sum), allowlisting text extensions, and forcing a no-omit output schema.
Codex Agent Makes Too Many Redundant Tool Calls (Fix)
Codex re-reads the same file 8 times and re-greps the same query 5 times. Fastest fix: run /plan first, add an AGENTS.md repo map, and keep reasoning effort at medium. Full diagnosis below.
Codex Stops Mid-Task With No Error: Causes and Fixes
Codex halts halfway through a multi-step task with no error — usually context compaction, a sandbox/approval denial, or a premature stop signal. Diagnose by the last tool call, then resume with codex resume --last.
Content Site Still Serves Old Article After Rebuild (CDN Stale)
You shipped a rebuild but production still serves the old article. Diagnose which cache layer is stale — CDN edge, browser HTTP cache, service worker, or stale HTML referencing old asset hashes — and purge the right one.
Content Site Sitemap Not Resubmitted After Update
You shipped 50 new articles but Search Console still shows last month's count. The sitemap regenerated locally and never reached the crawler — here's how to force a re-fetch in 2026.
Cursor Agent Mode: Tool Call Stuck Pending (Fix)
Cursor agent shows a spinner forever on a tool call. Nine times out of ten it is a shell command waiting on input — most often your own .zshrc. Here is the fast fix and the full diagnosis.
Cursor Composer Loses Context Mid-Refactor
Composer started strong then forgot which file it was editing — context window blew up; chunk the refactor and recheckpoint.
Cursor Rules Not Loading (Fix for 2026)
Composer ignores your .cursorrules or .cursor/rules. Usually a frontmatter syntax error, wrong path, deprecated format, or a glob that never matches the open file.
Gemini App Not Syncing Across Android Devices
Chats on your phone do not show on your tablet. Fix it fast: same Google account, Gemini Apps Activity on, app updated, and a cache-only reset that keeps your history.
Gemini Canvas Revert Not Working: Recover the Right Version
Click the previous-version arrow in Gemini Canvas and the text snaps back then jumps forward again? Version history is out of sync. Here is how to recover the version you wanted and stop losing edits.
Gemini Deep Research Times Out on Long Topics
Deep Research runs 20+ minutes then errors before delivering a report. Usually the topic is too broad — split it into sub-topics with a research plan and cap the sources.
Suno Cover Song Rights Warning on Upload
Distributor flagged your Suno cover for rights. Suno gives you the recording, not the composition — buy the mechanical license at upload and fill the songwriter fields. Fix in minutes.
Suno Credits Not Refreshing After Renewal
Card got charged for the new month but the balance still shows yesterday's number. Usually a replenish-time lag, an Apple-vs-web billing mismatch, or a stale browser session — and the fix is faster than a refund ticket.
Suno Prompt Too Long: Fix Silent Truncation
Suno silently weights only the first ~200 characters of your Style of Music field. Front-load genre and mood, move structure to lyric tags, and split long lyrics.
Suno Output Stereo Image Sounds Flat
Center-heavy, near-mono Suno mix with little L-R width. Fix it with prompt width cues, by panning stems in Suno Studio, or with a mid-side widener in post.
AdSense "Invalid Traffic" Warning: Fix and Appeal
Earnings clawed back or ad serving limited after AdSense flags invalid traffic. Tell apart a temporary limit from a closure, find the source, and appeal correctly.
AI Generation Credits Burned Through Too Fast
Monthly image/video/music quota gone in a day. The three habits that burn fastest, with current per-second credit costs and the exact toggles to fix.
AI Image Generation Blocked by Safety Filter
A normal-looking image prompt gets refused — one word tripped the filter. Binary-search the trigger and rewrite it in 60 seconds.
AI Image: Conflicting Lighting Directions (Fix)
Subject lit from the left, sun on the right, shadows pointing nowhere consistent. Pin one key light by direction, quality, source, and color temperature.
AI Image Looks Like an Overprocessed 3D Render (Fix the CGI Look)
You wanted a photograph, got plastic-skinned CGI. The fast fix: strip render keywords, drop CFG/guidance, switch to a true-photo model. Five stacking causes, six steps.
AI Image Oversaturated Colors: 6 Causes + Fix Path
Skin is highlighter orange, grass is neon lime. Style words, CFG, and color LoRAs stack into a billboard. Strip the boosters, generate flat, then push saturation in post.
Fix AI Image Skin That Looks Waxy, Doll-Like, or Wrong-Colored
Skin looks plastic, jaundiced, over-smoothed, or doll-like. Beauty LoRAs, color-cast lighting, missing negatives, and Flux's default smoothing are the usual culprits. Here is the diagnosis and fix order.
AI Image Unnatural Pose: Fix Broken Limbs and Twisted Necks
Arm bends backward, neck twists past human range. Feed an OpenPose skeleton via ControlNet, use concrete action verbs, pull the camera back, and pick an anatomy-strong checkpoint.
AI Image Has a Fake Watermark or Garbled Signature
A watermark-shaped smudge or fake signature in the corner is training-data residue, not a real watermark. Negative-prompt it (SD only), crop the corner, or inpaint it out.
Fix AI Image Wrong Perspective or Scale
Flat tables, sideways stairs, oversized heads. Open the prompt with a 5-7 word camera block (focal length + viewpoint + perspective style). Works in Midjourney, ChatGPT Images, Nano Banana, and ControlNet.
AI Suggested a Stale Dependency: Fix It Fast
An AI agent recommended an abandoned npm/PyPI package. Triage it in 3 seconds with npm view, swap it for the modern replacement, and stop it recurring.
AI-Generated Tests Pass But Feature Is Broken
All green, ship it, prod breaks. The tests covered the happy path only and mocks shielded the real branches. Five causes and the fastest fix.
AI Video Ends Abruptly Mid-Action
Clip cuts to black before the motion completes. Fix it by adding a settle beat to the prompt, setting an end frame, and budgeting 1-1.5s of ending time.
AI Video Transitions Too Abrupt
Two clips feel hand-cut with scissors? Match clip A's end frame to clip B's start frame, unify color, and add a short dissolve plus a J/L cut. Step-by-step fix.
AI Video Color Shifts Mid-Clip: 6 Causes + Fix Path
Same shot, but the tint suddenly turns colder or redder. The model re-guesses color temperature between frames — pin it with a Kelvin spec and unify with a LUT or shot match in post.
AI Video Continuity Breaks Between Clips: Fix Wardrobe & Prop Drift
Red hat in clip 1, blue in clip 2, gone in clip 3? Multi-clip generation has no shared anchor. Lock one tagged reference image and chain last frame to next first frame.
AI Video Export Has Black Frames or Drops
A chunk goes black mid-clip, or the file freezes. Usually it's a codec/player issue, not a bad render. Diagnose with ffprobe, then re-encode with ffmpeg.
AI Video Stuck in the Generation Queue Too Long
30 minutes at 0%? Hard-refresh first (often it already finished), cancel truly-hung jobs, free your concurrency slot, submit off-peak UTC, or fall back to a lighter platform.
Build Output Exceeds Platform Size Limit: Find It, Cut It, Gate It
Vercel, Cloudflare, and Netlify all cap function and asset size. Find the bloated dependency, trim it, and add a CI guard so it never recurs.
CAA Record Blocks SSL Certificate Issuance
Custom domain on Vercel / Cloudflare / Firebase and the cert never issues? A leftover CAA record is locking out your host's CA. Here's the fast fix.
ChatGPT 2FA Locked Out After Losing Your Device
New phone, old Authenticator gone, no backup codes — try the login screen's 'Try another method' link first, then help.openai.com identity review (24h-7 days).
ChatGPT Canvas Not Working: Why It's Gone on GPT-5.5 (and Fixes)
Canvas won't open on GPT-5.5 because OpenAI removed it (May 2026). Plus the browser, extension, and cookie fixes for legacy models.
ChatGPT Custom GPT Knowledge Files Not Being Used
Knowledge files configured but the GPT says "I don't see that file" mid-chat. Force retrieval, prune to under 12 files, and verify indexing — here is the full fix.
ChatGPT Deep Research Failed: Causes and Fixes
You ran Deep Research and 10 minutes later got a thin, generic report or a failure — quota downgrade, vague prompt, blocked sites, or a server incident. Here's how to tell which.
ChatGPT Image Edit Doesn't Apply: Fix It in 2 Steps
Asked ChatGPT to change the background and the image came back basically the same? Use the Select tool to scope the edit, then a keep/change/avoid prompt. Verified June 2026.
ChatGPT Project Context Bleeds From Old Chats: 6 Causes + Fix
ChatGPT carries details from a previous chat or Project into the current one. The fastest fix is project-only memory, plus untangling the Memory / Project / chat-history layers.
ChatGPT Plus Subscription Not Recognized
Paid for Plus but ChatGPT still says Free — fix the App Store vs Web account mismatch, force an entitlement refresh, or catch a silently failed charge.
ChatGPT Team/Business Seat Not Activating: 5 Fixes
Admin sent the invite, the invitee clicked, but login still shows Personal Free. Usually an email alias mismatch, a past-due payment, SSO enforcement, or the invite landing on the wrong account.
Claude Code Accidentally Committed a Secret
Claude Code swept your `.env` or API key into a commit. Rotate the key first (always), purge git history second, then block it for good with a deny rule, scanner, and push protection.
Claude Code Creates a Pile of Unused Helpers
You asked for one function; the PR ships five "might be useful later" siblings nobody calls. Bound scope in the prompt and CLAUDE.md, auto-delete dead exports with knip --fix, and lock it in CI.
Claude Code Skips or Weakens Failing Tests
Claude Code turns tests green by adding .skip, deleting assertions, or loosening matchers. Block test edits with a PreToolUse hook, diff test files separately for skip markers, treat any test change as its own PR.
Claude MCP Server Keeps Disconnecting: Fix It for Good
MCP server connects then drops in Claude Desktop or Claude Code — fix the stdio crash, OAuth expiry, config path, or 60s startup timeout.
Claude Mobile App Not Syncing Chats: Fixes That Work
Web chats missing in the Claude mobile app? Fix it fast — wrong account, stale app, archived chats, or a blocked network. Step-by-step, verified June 2026.
Claude Project Instructions Ignored: Why & How to Fix
Your Claude Project says "no emoji" but answers still have them. Project instructions are soft constraints — here is how to make Claude actually follow them.
Cloudflare Pages Build Cache Stays Stale
CF Pages ships old deps after a version bump because it restored a stale dependency cache. Commit the lockfile, clear the cache, pin Node.
Cluster Articles Cannibalize Each Other's Keywords
Three articles fight for "how to use claude API" and Google ranks none. Confirm cannibalization in Search Console (query then Pages tab), pick one pillar, merge or differentiate the rest, and consolidate links.
Codex Can't Access a Private Repo: Fix the 3 Permission Layers
Codex shows "unable to clone" or "Repository not found"? Usually the ChatGPT Codex Connector GitHub App isn't installed on the org, the repo isn't in its allowlist, or your SSO/OAuth grant lapsed. Fix it in priority order.
Codex Environment Setup Fails Before the Task Starts
Codex stalls at Setting up environment — usually a runtime mismatch, a private-registry token, or an install that blows past the cached container. The fast fixes, verified for June 2026.
Codex PR Too Large to Merge
50 files, 1,500 lines, nobody will review it. Cap diff size with Codex Plan Mode, an AGENTS.md PR budget, and a CI gate — and split the one you already have.
Cursor Request Billing Confusion: Fast/Slow vs the New Credit Pool
Your $20 Pro credits vanish mid-month and Cursor says you've hit your limit. Here's how Cursor's usage-based billing actually works (it killed fast/slow requests in 2025) and how to stretch your quota.
Cursor Model List Out of Date vs Official Site
Cursor's site advertises a model but your local Settings → Models picker doesn't show it. Old client, stale cache, or staged rollout — here's how to tell which and fix it.
Cursor Rules Not Being Loaded (.cursorrules / .cursor/rules)
Cursor ignores your rules: legacy .cursorrules is skipped in Agent mode, a broken .mdc frontmatter is silently dropped, wrong location/extension, BOM, or a stale cache. Diagnose and fix.
Expired Provisioning Profile Causes Build Rejection
Apple emails ITMS-90161 / ITMS-90165 after upload. Find which artifact expired (cert, profile, or WWDR) and regenerate it.
Firebase Quota Exceeded: Find the Runaway and Fix It
Firestore reads, Functions invocations, Hosting bandwidth — each free-tier metric has a hard line. Here's how to find which one tripped and stop the bleeding.
Fix Firestore "The query requires an index" (FAILED_PRECONDITION)
Firestore throws FAILED_PRECONDITION because a multi-field where + orderBy needs a composite index. The fastest fix, the CLI workflow, and how to confirm it's built.
Gemini 2.5 Output Gets Truncated
Mid-sentence `…` and it stops — max output tokens, safety filter, or stream drop.
Gemini Canvas Fails to Load
Canvas button does nothing or the pane stays blank — fix it via extensions, model choice, the direct /canvas URL, cookies, Workspace policy, or region.
Gemini Context Window Feels Shorter Than Advertised
1M tokens is the headline, but a 100-page PDF already overflows. The fix depends on your Gemini plan tier and which surface you use.
Gemini Saved Info Not Persisting Across Sessions (2026 Fix)
You told Gemini "I'm a PM" but the next chat still asks — Memory is off, Keep Activity is off, or you're on a work account. Here's the exact fix order.
Gemini Can't Read Your Gmail / Drive: The 6 Real Causes
Gemini says "I don't have access to your Drive" or "I can't find that email"? Fix the Connected Apps toggle, Smart features gate, and account mismatch.
Infinite Scroll Pages Don't Get Indexed
Only the first 20 items render in HTML; the next 100 load on scroll and Googlebot never sees them. Add crawlable ?page=n URLs to fix it.
Last-Modified Response Header Missing
Page updated but Google won't re-crawl. Check sitemap lastmod first, then fix the missing Last-Modified / ETag header so Googlebot can run conditional crawls.
Fix Outdated Screenshots in Tutorials
Screenshots show last year's UI and steps don't match what the reader sees — trust drops, bounce rises. Audit by platform, version-stamp, then automate captures so they never rot again.
Pagination Canonical Confusion: Should page/2 Canonical to page/1?
Search Console flags page/2+ as duplicate. Should each paginated page self-canonical or point to page 1? Google's current guidance, verified June 2026.
Prompt Mixes System and User Instructions
Persistent rules stuffed into the user message so the model can't prioritize them. Move them to the system / developer channel.
Suno BPM Off Target — Tempo Won't Hit 128 Fix
You wanted a 128-BPM dance track, got a 95-BPM ballad — style words pulled the tempo.
Suno Cover Song Licensing Confusion
Can you commercialize a Suno cover? Copyright lives on three layers: composition, lyrics, master.
Suno Credits Burn Through Too Fast
Your Pro plan tanks in under a week. Here's where the credits actually go and how to triple your monthly output.
Suno Unwanted Language Mixing in Vocals
Your Chinese (or Spanish, Japanese, French) track leaks English ad-libs. Fix the style field, lyric script, and section directives so Suno stays in one language.
Suno Vocals Sound Thin After Pitch Shift
Pitch a Suno track up 3 semitones and the vocal goes metallic. The fix: regenerate in the target key, or cap the shift at 2 semitones with formant preservation on.
Suno Stem Export Missing or Incomplete: Fix in 3 Steps
Clicked Export in Suno and got one mixed MP3 instead of separate vocal / drum / bass stems? Here is the exact menu path, plan tiers, and credit cost to get up to 12 stems.
Supabase Edge Function Cold Start Slow: Causes + Fix
First request takes 1–5s while warm ones are 100ms. Diagnose the real cause (heavy imports, top-level await, region) and cut boot time.
Supabase Connection Pool Exhausted: Fix the Serverless Anti-Pattern
`remaining connection slots are reserved` and `too many clients already` — switch serverless to the port 6543 pooler, the right way.
TestFlight Tester Cannot Redeem Invite Code
Tester taps your TestFlight link and sees "This code is invalid" or "not accepting new testers." The 8 real causes (region, Apple ID, full group, expired build) and the fastest fix for each.
Wildcard DNS Doesn't Match a Deep Subdomain
`*.example.com` has an A record but `a.b.example.com` still NXDOMAINs. DNS wildcards cover exactly one label — here's the fix.
AI Gives a List When You Asked It to Do the Work
You asked the model to write, refactor, or draft something and got a 10-bullet plan instead. Here is why it switches to advice mode and the exact prompt edits that force a finished artifact.
AI Ignores the Most Important Constraint: Why and How to Fix It
You listed five rules. The model honored four and quietly dropped the one that mattered most. Here is why constraints get dropped and how to make the critical one stick.
AI Over-edits When You Asked for a Light Rewrite: How to Force Minimal Edits
You asked for a small polish and got a full rewrite that lost your voice. Here is how to constrain ChatGPT, Claude, and Gemini to surgical, byte-minimal edits.
Ambiguous Evaluation Criteria Cause Weak Answers
Your criteria are vague — "engaging", "professional", "innovative" — so the model interprets freely. Turn each adjective into a testable rule with a 10-second check.
App Rejected for Misleading Claims or Overpromising
Apple flagged your description, screenshots, or in-app copy under Guideline 2.3.1 as misleading. Diagnose which claim triggered it and fix metadata or binary fast.
App Review Notes Are Unclear: Rewrite Them So Reviewers Stop Asking
Your App Review notes exist but Apple keeps citing Guideline 2.1 or says the demo account failed. Put credentials in the Sign-In Required fields, write steps as a numbered form, and resubmit notes-only.
App Store Localization Confusion: 6 Causes + Fix Matrix
A translated App Store listing diverges from the base language and triggers a Guideline 2.3.7 rejection. Audit every locale, then ship a metadata-only resubmission — no new build needed in most cases.
App Store Screenshot / Metadata Rejection: 7 Causes + Fix
Apple rejected for screenshot, description, keyword, or category metadata under Guideline 2.3 — even though the binary passed. Identify the surface and fix it.
App Version Stuck in "Waiting for Review" Too Long
Your App Store submission has sat in "Waiting for Review" for days. How to tell whether to wait, fix a silent block, or escalate — current for 2026.
Conflicting Instructions Weaken AI Output
When two prompt rules fight, the model averages them into something nobody asked for. Rank your constraints so it knows which to drop.
In-App Purchase Not Restoring Correctly Across Devices
A returning user taps Restore Purchases and gets "Nothing to restore" even though they own the product. Fix the StoreKit, validation, and entitlement layers.
Model Follows the Last Sentence and Ignores the Earlier Rules
A casual aside at the end of your prompt can overwrite the careful rules at the top. Anchor the hard rules at both ends so the last line stops winning.
Long Background Hides the Actual Task
Your prompt has three paragraphs of context and one buried sentence asking for the deliverable, so the model summarizes the background instead. Here is how to put the task where the model will actually read it.
Missing Examples Cause Output Drift (Few-Shot Fix)
Describing a tone or shape in words makes the model approximate; pasting one concrete example makes it match. How to pick, place, and structure 1-5 examples to lock the output you want.
Mixed Tone Instructions Make Output Read Schizophrenic
"Professional but friendly, formal but warm" gives the model two voices to average. Fix: pick one primary tone, anchor it with an example, demote the rest to mechanical rules.
Model Fills Missing Details With Invented Assumptions
You gave a partial spec; the model invented the rest to look complete. Add an explicit UNKNOWN rule, a nullable schema, and a verify pass to stop it.
Negative Constraints Are Too Vague
"Do not be generic" tells the model what not to do without telling it what to do, so it dodges the word and keeps the behavior. Pair every 'do not' with a concrete 'do'.
New Build Uploaded But Not Appearing in App Store Connect
Xcode says upload succeeded, Transporter says delivered, yet the build is missing from App Store Connect. The three quiet states it's actually in, and the fix for each.
No Output Format Specified: Why You Get a Wall of Prose
You wanted a structured answer and got 600 words of paragraphs. Here is how to force clean JSON or a fixed template, every run.
Prompt Does Not State What Success Looks Like
When a prompt has no success criteria, "good" defaults to whatever the model thinks sounds confident. Here is the 5-line success block that ends revision purgatory.
Output Sounds Polished But Is Not Actionable
The answer reads beautifully and you cannot use a line of it. Here is how to force file paths, commands, and numbers via a schema instead of more adjectives.
Prompt Asks for "Best" Without Defining a Decision Rule
Run the same "what's best?" prompt three times, get three answers. Replace "best" with an axis, weights, and a tie-breaker to get one defensible pick.
Copied Prompt Fails on a New Task: How to Fix It
A prompt that worked elsewhere produces nonsense for your current task because the old audience, format, and examples are still baked in. Here's how to rebuild from the goal.
Prompt Uses Emotional Wording Instead of Operational Instructions
"Please make it amazing!" feels persuasive, but it tells the model nothing to act on. Swap adjectives for checkable rules.
Prompt Lacks Context Hierarchy: Why the Model Answers the Wrong Part
You pasted everything as a flat block, so the model can't tell critical lines from background. Add labels, tag your sources, and put the task where attention is highest.
Prompt Lacks Source Material Hierarchy
You attached three documents and the model treated them all as equally authoritative — including the rejected draft. Here's how to label provenance so the right source wins.
Prompt Does Not Define the Intended Audience
No audience in the prompt means the model writes for an imaginary average reader and pleases no one. Fix it with a one-line audience block that calibrates vocabulary, depth, and tone.
Prompt Too Broad to Produce Useful Results
A sweeping question gets a sweeping non-answer. Here is how to narrow a prompt until exactly one concrete answer is possible — with templates and a fix checklist.
Restore Purchases Button Missing: Fix the 3.1.1 Rejection
Apple flagged your app under Guideline 3.1.1 for a missing Restore Purchases button. Add the button to your paywall and Settings, wire it to StoreKit, and resubmit.
Rejected: Reviewer Can't Access a Gated Feature (2026)
Apple rejected under Guideline 2.1 because the reviewer couldn't get past a paywall, region lock, role gate, or invite gate. Fix it with notes plus server config, usually no new build.
Role Instruction Alone Is Not Enough
"You are a senior engineer" sets the tone but does not change the answer. Research says expert personas rarely raise accuracy; rules, format, and examples do.
Requested Style Conflicts With Requested Output Format
"Be warm and conversational, return strict JSON" pulls in two directions. Pick one, scope warmth to prose fields, or split into two passes.
Subscription Entitlement Mismatch After Purchase (StoreKit 2 Fix)
User paid but your app still shows free, or canceled but still Pro. The server-authoritative StoreKit 2 fix, with App Store Server Notifications V2 and reconciliation.
TestFlight Beta Review Stuck on Waiting for Review — Fix It
Your TestFlight build has sat in Waiting for Review for days. Here is what is actually happening and what you can do about it.
TestFlight Build Expired — What to Do Next
Testers see "This beta has expired" or the build shows Expired in App Store Connect. Why it happens and how to push a replacement fast.
TestFlight Build Not Showing on a Tester's Device — Fix Checklist
Build is Ready to Test and the tester accepted the invite, but it never appears in their TestFlight app. Walk the ordered checklist that fixes 95% of cases without re-uploading.
TestFlight External Testers Not Getting the Invite: 7 Causes + Fix
You added external testers in App Store Connect but they never get the TestFlight invitation email, or the public link says it is not accepting testers. Here is how to find and fix it.
Too Many Examples Overwhelm the Prompt
Stacking 5+ examples makes the model copy whichever one resembles your input instead of executing the task. Cut to 1-3, and on reasoning models try zero-shot first.
Prompt Asks for Too Many Tasks at Once
Stacked five tasks in one prompt and got one good answer, one weak one, and three half-finished? Here is how to split the work so every task lands.
AI Changes Scope Because the Task Boundary Is Unclear
You asked the model to fix one function; it also reformatted two others and renamed a constant. Draw an explicit in-scope / out-of-scope boundary so the edit holds.
Ad Blockers Are Quietly Lowering Your Real RPM
A big slice of your audience runs an ad blocker, so your true fill rate and earnings are lower than the AdSense dashboard shows. Here is how to measure the gap and recover the revenue.
Ad Density Quietly Violating AdSense Policy
You think 5 ads per page is fine. AdSense's Valuable inventory policy disagrees. Find the safe density for your layout, with the exact Better Ads thresholds.
AdSense Shows on Homepage But Not Article Pages: 6 Causes + Fix
Homepage AdSense renders, article pages stay blank. Usually a template-only difference: a missing script tag, a CSS-collapsed slot, a wrong ad-slot ID, or thin content. A DevTools side-by-side method to pin which one.
ads.txt Not Found or Not Verifying in AdSense
AdSense shows "Earnings at risk — you need to fix some ads.txt file issues." How to deploy ads.txt to the right place, verify it with curl, and clear the warning.
AdSense Account Approved But This Site Stuck on Getting Ready (2026)
Your AdSense account passed years ago, but a new site sits in "Getting ready" for weeks. How per-site review works in 2026, the exact status labels, and how to stop waiting.
AdSense Mobile vs Desktop Fill Rate Gap (2026 Fix)
Mobile fill rate sits at 55–70% while desktop is 92–98%. Here's which part of the gap is structural, which part is your config, and the fastest fix.
AdSense Balance Stuck Below the $100 Threshold (2026 Fix)
Your AdSense balance keeps sitting under the $100 payout threshold after months of ads. Here is the math, how to find which bucket you are in, and what actually moves it.
AI Content Lacks Unique Value: Why It Won't Rank or Pass AdSense
AI articles read fine but rank position 47 and get AdSense-rejected for "low value content." The fix is information gain: add 3 of 6 concrete additions (experience, data, contrarian POV, expert quote, proprietary screenshot, unique synthesis).
Article Count Looks Big But Real Coverage Is Weak
"We have 800 articles!" — but 60% are bilingual duplicates, drafts, or thin redirects. Count what matters: unique, indexable, substantive URLs.
Article Published Date and JSON-LD Date Mismatch
The visible "Published / Updated" date does not match `datePublished` / `dateModified` in JSON-LD. Why this is more than a cosmetic bug.
Auto Ads Appear in the Worst Places
AdSense Auto ads put a banner over your H1, an anchor ad over the CTA, or a full-screen vignette on every click. Constrain placement with the 2026 format groups and Excluded areas without killing 20-60% of revenue.
Bilingual Pages Drift Apart Over Time
EN updated 5 times, ZH once: stale screenshots, broken cross-links, hreflang ignored. Audit drift with a script, decide per pair, automate the sync. June 2026.
Breadcrumb JSON-LD Doesn't Match Your Visible Breadcrumb
Rich Results Test passes but Search Console flags Breadcrumbs, or the SERP trail looks wrong. Diagnose the real cause and align JSON-LD with the visible UI (June 2026).
Canonical Changed But Google Still Shows the Old URL
You set canonical to a new URL, but weeks later Google still ranks the old one. Canonical is a hint, not a command — here's how to align every signal so Google switches.
Category Page Too Weak to Rank or Get Indexed
Your category page is a title plus cards, so Google sees navigation, not content. Add a 300-word editorial intro, a curated "start here," and a real take to turn it into a rankable hub article.
Category Pages Not Indexed: Causes + Fix
Your /category/ pages sit at 'Crawled - currently not indexed' in Search Console while articles index fine. The fastest fix and the full diagnosis, verified June 2026.
Custom Domain Works on Vercel but Not Firebase (2026 Fix)
Same domain binds fine on Vercel but Firebase Hosting stays Pending or never gets SSL. The exact DNS records Firebase needs, what to remove, and how to confirm the fix.
Pages Suddenly Deindexed: Manual Action or Algorithm?
A well-ranking page vanishes from Google. Manual action or core-update demotion? How to tell which in 5 minutes, then the right fix for each.
Domain Points to the Wrong Hosting Provider
You changed hosts but DNS still resolves to the old one. Run dig NS to find where your authoritative records actually live, then fix them at the right provider.
Draft Pages Accidentally Published
Pages still marked `draft: true` got built, deployed, and indexed with placeholder text. Audit, deindex with 410, then add CI guards so the build can't produce a draft in production.
Duplicate Domain Versions Indexed: http, https, www, non-www
Google indexed all four versions of your site, splitting link equity four ways. The platform-level 301 + canonical plan that consolidates them into one.
Duplicate Meta Descriptions Across Many Pages: The Fix
A crawl flags hundreds of pages sharing one meta description. There's no ranking penalty, but it quietly costs you clicks. Here's the targeted fix, not a weekend rewrite.
Duplicate Site / Domain Confusion in AdSense Review (2026)
Same content on yourbrand.com and yourbrand.net gets AdSense flagged as duplicate or stuck in review. Pick one canonical domain, 301 the rest, fix it.
Duplicate Titles Across Many Pages: 6 Causes + the CI Fix
An audit flags 80 pages sharing one `<title>` — usually template fallback, pagination, or a bilingual collision. Diagnose the bucket, rewrite for specificity, and add a CI check so it never recurs.
FAQ Schema Invalid or Snippet Gone: 2026 Fix Guide
FAQ rich results vanished or Rich Results Test errors on FAQPage? Google deprecated the feature in May 2026. What that means and how to keep your schema valid.
Google Crawls My Homepage But Never the Article Pages
Search Console crawls your homepage daily but article pages stay at "Discovered — currently not indexed." Split discovery vs. crawl-budget failures and fix the right one.
Google Publisher Tag (GPT) Not Loading: Fix Empty Slots
Switched from AdSense `<ins>` to GPT and slots stay empty? Diagnose googletag is not defined, id mismatches, the cmd.push race, and SPA double-init in 10 seconds.
Googlebot Crawl Spikes But Impressions Stay Flat
Crawl Stats shows Googlebot fetching hundreds of URLs a day, but the Performance report stays flat. Here is why crawling is not indexing, and how to unclog the middle.
Homepage Can't Distribute Authority: Cut 200 Links to 30
200 outbound links on the homepage split its PageRank ~200 ways. Cut to ~30 deliberate destinations and route long lists through index pages so authority concentrates where you want rankings.
Hreflang x-default Confusion in Bilingual Sites
Set hreflang for en and zh but a validator flags missing x-default? What x-default does, the 6 configs that break it, and copy-ready fixes.
HTTPS Not Forced — Site Loads on Both http and https
Your site answers on both http and https, so Google indexes two copies and Chrome flags http as Not Secure. Add a 301 redirect plus an HSTS header to fix it.
Indexing Coverage Drops After a Site Redesign
After a redesign, Search Console's indexed page count falls. How to tell normal re-evaluation from real structural damage, and the exact checks to run.
Internal Links Severely Uneven — A Few Pages Get Everything
Top 10 pages hold 80% of internal inlinks; 200 pages have 0-2. Audit inlinks in Screaming Frog, add body-text links to the starved 20%, and replace 'latest 5' with a smart related widget.
Large Content Site Indexing Slowly
Thousands of pages, only a fraction indexed. How to tell if it's really crawl budget, and what actually moves the needle in 2026.
Manual AdSense Ad Units Stay Blank on Astro / Next Static Sites
Your AdSense `<ins>` block sits empty on Astro, Next.js export, SvelteKit, or Hugo. Diagnose the push() timing, double-push, and SSG-no-JS traps and fix the slot.
Many Pages, Few Impressions: 7 Causes of a Dead Long Tail
500 articles, top 20 pages get 80% of impressions, the tail gets 0-5/month. Power-law is normal; a dead tail is the bug. Validate keywords, fix intent and links, and tell impression-dead from click-dead in the AI Overviews era.
Meta Robots vs X-Robots-Tag — Which One Wins
When `<meta name="robots">` and the `X-Robots-Tag` HTTP header conflict, Google merges them and takes the most restrictive value. How to diagnose it with curl and keep both in sync.
Optimizing AdSense Before You Have Traffic
AdSense is approved but you earn $0.50/day on 10 visitors. The traffic threshold where ad tuning starts to matter, plus the 2026 Auto ads settings that changed.
Name Server vs DNS Records — Where Do I Actually Change Things (2026)
Beginners confuse name servers (NS) and individual DNS records (A, CNAME). Changing one without understanding the other causes hours of debugging.
New Site Stuck in the Discovery Phase
Your new domain has been live 4-8 weeks, sitemap submitted, but every URL shows "Discovered – currently not indexed". Here is what actually moves the needle in 2026.
I Set Noindex But the Page Is Still in Search Results
You added `<meta name="robots" content="noindex">` weeks ago but the page is still in Google. The six reasons, in hit-rate order, with the curl checks to tell them apart.
Noindex Accidentally Applied to Public Pages
A template default, env leak, or CDN header left `noindex` on pages that should be public. How to find the real source, remove it, and force a clean re-crawl.
Old Deployment URL Appears in Search Instead of Custom Domain
Google shows your-app.vercel.app or your-site.web.app in search instead of your custom domain. Why it happens and the exact redirect + canonical fix.
Orphan Content Pages Drag Down Site Quality
Pages with zero internal inbound links rarely rank. Find true orphans with a crawler or a script, then decide per page: reintegrate with body links or remove with 410/noindex.
Orphan Pages: No Internal Links, So No Indexing
A URL sits in your sitemap but no page links to it. Google treats it as unimportant and parks it at 'Discovered — currently not indexed.' Fix: add 2+ contextual internal links from indexed pages.
Page Is Indexed but Has Zero Impressions in Search Console
URL Inspection says the page is on Google, but the Performance report shows 0 impressions. Here is what that state actually means and how to fix it.
Fix AdSense Rejection: Privacy Policy Missing or Incomplete (2026)
AdSense rejects sites whose privacy policy doesn't name Google, third-party cookies, and personalized advertising. Here's the exact wording it looks for and how to resubmit.
Redirects Broken After Domain Change: Fix the 404s and Recover SEO
Moved old.com to new.com and now Search Console shows hundreds of 404s. How to build a complete redirect map, deploy it on the old domain, and verify every URL returns a 301.
Resubmitting URL Inspection Won't Force Google to Index a Page
You clicked "Request Indexing" 10 times and the URL still says "not on Google." Here is why URL Inspection isn't a force-index button, and what actually moves the needle.
Sitemap Lists URLs That Carry noindex (How to Fix the Conflict)
Your sitemap.xml lists URLs that render `<meta name="robots" content="noindex">`. Google indexes some and not others. Why it happens and how to make both signals agree.
RSS / OG URLs Still Show example.com (Placeholder Domain)
Your RSS items and og:url still point at a starter-template placeholder like example.com or your-domain.com. Here is exactly where it leaks and how to fix every spot in one pass.
Search Console Sees Many Low-Value URLs
"Crawled — currently not indexed" balloons to thousands of `?sort=`, `?page=`, tag-combo URLs. Triage by source, block via robots.txt / canonical / noindex, and reclaim crawl budget — without the common mistake that hides your noindex tag.
Search Console Indexed Count Drops With No Obvious Reason
The Indexed line in the Search Console Pages report falls by 50–200 URLs overnight with no errors and no changes. Here is how to find which URLs left and decide what to do.
Search Console Property Mismatch After Domain Move
You moved domains but Search Console still tracks the old one, or the new property is empty. Migrate correctly with Change of Address without losing historical data.
Content Site Grew Fast But Every Article Looks the Same
100 articles in 3 months, same structure and same examples? That's templated thinking, and as of 2026 it's exactly what Google's scaled-content-abuse policy targets. Audit, rotate templates, force a unique angle per piece.
Site Loads Intermittently After Connecting a Domain
One refresh the site loads, the next shows a hosting error or parking page. The real causes after binding a domain to a new host, and how to force every resolver onto the new record.
Sitemap Still References Old Domain After Migration
After a domain move, sitemap.xml still lists old-domain URLs and Search Console flags 'URL not allowed.' Find the stale site-URL config and fix it for good.
Sitemap URLs Missing From the Search Console Pages Report (2026)
Your sitemap is submitted and shows Success, but its URLs never appear in the Pages report. The exact checks that find the cause, with current GSC menu paths.
Fix the SSL Mixed Content Warning (HTTPS Site Shows "Not Secure")
Your site is on HTTPS but the browser shows "Not fully secure." Diagnose which of 6 mixed-content cases you have and fix it for good — with current 2026 Chrome behavior.
Stale Articles Haven't Been Updated in Years
Half your articles are 3+ years old and reference tools that changed. Refresh the high-traffic ones with real edits (not date-bump tricks) so they rank and get cited again.
Structured Data Invalid After a Template Change: Find the One Broken Field
A layout refactor or framework upgrade broke your JSON-LD site-wide. Map the Rich Results Test error to its cause and fix the single field that regressed.
Tag Pages Indexed But Article Pages Lag: Causes + Fix Path
Google indexed every tag archive page, but your article pages are stuck in Discovered or Crawled - currently not indexed. Here is why, and the link-distribution fix.
Many Pages But Still Too Thin for AdSense Review
200 articles but AdSense rejects with "low value content"? Page count isn't the metric — unique value per page is. The fix is usually cut and deepen, not add.
Thin Pages Get Deprioritized by Google: Diagnose, Merge, or Remove
Google quietly stops crawling and indexing your thinnest pages with no penalty notice. Here is how to find them and decide whether to expand, merge, or remove each one.
Too Many Tags Create Thin Archive Pages
800 tags, 600 with 1-2 articles each = 600 thin archive pages Google won't index. Set a per-tag article threshold, merge synonyms, noindex the rest, keep them out of the sitemap.
Too Many Thin Pages Are Dragging Down a Content Site
500+ pages and Google indexes few. Audit by word count + impressions, tag each page expand / merge / noindex / 410, and cut the weakest 20-40% to lift site-wide quality.
Topic Cluster Too Shallow to Rank for the Pillar
1 pillar + 2 supporting articles isn't a cluster — it's a stub. Real clusters run 8-12 supporting pages, ship over 2-3 months, and link bidirectionally. Here's how to design, build, and wire one.
TTL Too High: Why Your DNS Change Won't Propagate
Changed an A record but old caches won't expire? The TTL set BEFORE the change controls propagation. Diagnose your case and fix it the right way.
Twitter Card Image Not Showing When Sharing on X
Your X/Twitter link shows no image even though og:image is set. The 6 real causes, how to tell which one you have, and the fastest fix for each.
I Used the Search Console Removals Tool — Now What?
Search Console's Removals tool only hides a URL from Google for about 6 months (180 days), then it returns. It is not a permanent delete or a re-crawl button. Here's how to get the result you actually wanted.
VideoObject Schema Valid but No Video Rich Result
Your VideoObject JSON-LD passes Rich Results Test but Search Console shows no indexed video. The real cause is usually thumbnail, embed URL, or video prominence — here is how to find which.
WebSite JSON-LD Doesn't Match Your Site (Fix the Site Name)
Your WebSite JSON-LD declares a name / URL that doesn't match reality, so Google shows the wrong site name above your homepage. How to align it — and why the SearchAction half is now dead.
When "Slow Indexing" Is Actually Normal (Baseline Reference)
Realistic indexing-delay baselines for new sites, new sections, and post-redesign sites — plus the exact thresholds that mean it's a real problem.
www and non-www Both Open Separately
Both yourdomain.com and www.yourdomain.com load with a 200 and identical content. Why it splits SEO signals and the exact 301 fix per host.
Firebase Hosting cache: force fresh content after deploy
Deployed but visitors still see the old page? Fix it with this firebase.json cache-header config, a curl diagnostic, and the correct rollback command (verified June 2026).
Firebase Hosting Rewrites: When to Use Them (and When Not To)
Firebase Hosting rewrites map URLs to a Cloud Function, Cloud Run, or a single-page app. The three patterns that actually work as of June 2026, the modern functionId syntax, and the traps each one hides.
Firebase Hosting route 404 after deploy: 5 causes and fixes
Pages work locally but 404 on Firebase Hosting. Diagnose it in ten minutes with the exact request priority order, firebase.json snippets, and curl commands that pinpoint the cause.
Why your Vercel build failed: 7 causes and the exact fix
A Vercel "Build failed" is almost always one of seven causes: Node version, missing env var, type error, dependency drift, OOM, wrong output directory, or timeout. Match the log line, paste the fix.
A vs CNAME Confusion: Which DNS Record Do I Use?
Your host says A, a tutorial says CNAME, and the apex won't resolve or email broke. A web-verified cheat sheet for apex vs www vs subdomains (Vercel, Netlify, GitHub Pages, Cloudflare).
AdSense Approved But Ads Not Showing: Fix It Fast
Code is on the page but the ad spot is blank. The fastest fix, plus the 7 real causes ordered by how often they break, with exact checks for each.
AdSense Auto vs Manual Placements: Fixing the Mess When You Mixed Both
Troubleshoot the common AdSense placement problems — clutter, double-stacked units, layout shift — when Auto Ads and manual placements conflict. For the strategic comparison, see the linked guide.
AdSense "Low Value Content" Rejection — How to Recover
What "low value content" actually means in 2026, how to diagnose which bucket your site is in, and the recovery steps that get sites approved on reapply.
AdSense "No Ads Available" (Empty Slot)
An AdSense slot renders blank with "no ad served." Diagnose with DevTools, then fix inventory, size, policy, or ads.txt causes.
AdSense Policy Warning: Decode It and Clear It Fast
An AdSense policy warning is a countdown. Decode the exact Policy center category, fix the cited URLs only, then Start review process — without burning your limited reviews.
AdSense Script Installed but Slots Stay Blank
adsbygoogle.js returns 200 but the ad slot stays empty. Read data-ad-status, rule out account review, and fix the wiring in minutes.
AdSense "Getting Ready" / "Requires Review" — What To Do
Your AdSense site is stuck on "Getting ready" or "Requires review." Here's how to tell a normal queue from a real problem, and what to fix.
Fix AdSense Slowing Down Your Page (CWV Recovery)
PageSpeed tanked after adding AdSense? It's almost always 3-4 wiring issues, not the ads. Fastest fix: reserve ad slot height (CLS) and async the script. Full diagnosis + 2026-current code.
AI Coding Agent Loops Without Making Progress
Your agent keeps trying the same fix or oscillates between two states. How to spot the loop in 30 seconds and kill it with one prompt.
Agent Rollback Was Incomplete: Roll Back by Domain, Not by git reset
The agent said 'rolled back' but the migration, the dist/ bundle, a Stripe webhook, and a PostHog flag are still live. Here's the six-domain checklist and the exact inverse commands that finish the job.
AI Answer Too Vague: Force Specifics in 3 Steps
You asked a concrete question and got a "depends on your situation" non-answer. Six prompt shapes cause it; here are the exact rewrites that pull a real decision out of the model.
AI Video Transition Looks Awkward Between Clips
The cut between two AI clips feels jarring. Match motion, color, and pacing, or let the model render the transition with start/end keyframes.
Build Passes Locally but Fails in CI After an AI Edit
AI added a dependency without committing the lockfile, or used a Node feature your CI image doesn't have. Reproduce it in 5 minutes and pin the gap shut.
AI Code Edits Broke the Build: Recovery + Diagnosis
After an AI run, npm run build fails. Locate the bad change in 10 minutes with diff triage, tsc --noEmit, and targeted git restore — no full reset.
AI Agent Overwrote .env / Environment Variables
An AI coding agent rewrote .env with placeholders or deleted it. Recover the real values, then hard-lock the file so it never happens again.
AI Image Gives Extra Fingers / Bad Hands
Six-finger hands still slip through in 2026. Fix the framing, run a hand-specific inpaint pass, and swap models — exact steps for Midjourney, SDXL, Flux, and Imagen.
AI Hallucinated Facts: Detect and Stop Confident Wrong Answers
The model invented a citation, API method, or number with full confidence. Here is how to spot it and force grounded, verifiable answers on the first try.
AI Hallucinated a File or Package That Doesn't Exist
Agent imports `src/utils/superhelper.ts` or a package that was never created. Find every bad import, then fix or replace it.
AI Anime Style Mixed With Realism: 6 Causes, 6 Fixes
You asked for anime, the model leaks photoreal skin, eyes, and lighting. Anchor a specific anime reference, strip realism cues, and match the checkpoint's own tag system.
AI Image Background Too Busy: Why It Happens and How to Fix It
The background steals attention from your subject. Name a background style explicitly, contrast the color, crop tighter, then inpaint or one-shot-edit the rest away.
AI Image: Character's Face Changes Every Generation (Fix)
Same description, different face every run. Lock identity with a reference image (Omni Reference, gpt-image-2, IP-Adapter FaceID), a fixed seed, and unique markers.
AI Image Composition Too Cluttered
Too many objects fighting for attention? Cut to one hero, add shallow depth of field, and use negative space. Fastest fix and per-tool steps for Midjourney, ChatGPT, Gemini, and SDXL.
AI Image Looks Soft or Low-Detail: 6 Causes, Fast Fix
Output is blurry, soft, or plasticky? The fix is almost always resolution, sampler steps, or a prompt with no detail anchors. Diagnose in 60 seconds, then fix.
AI Image Doesn't Match Your Prompt: Fix It
The model ignores half your prompt. Usually it's token order, conflicting styles, or negatives written inline. Here's the fix path by model.
AI Image Lighting Looks Flat / Bad
Subject looks flat, harsh, or amateur? Name the light setup with cinematography vocabulary (direction + quality + source + temperature). It beats adjectives every time.
AI Image Style Not Consistent Across a Series
Got 5 unrelated images when you needed 5 cohesive ones? Pin a numeric Midjourney sref code (or one IP-Adapter reference), lock the seed, and freeze the model. Verified June 2026.
AI Image-to-Video Drifts From Reference Image
Starts as image A, ends as someone else. Lower motion, cap clip length, and lock identity with reference + text anchors to stop the drift.
AI Image Wrong Aspect Ratio: Why 9:16 Comes Out 1:1 (Fix Per Platform)
You set 9:16 and got a square. Per-platform aspect syntax, supported-ratio lists, and UI overrides for Midjourney, ChatGPT, Gemini, SDXL and Flux, verified June 2026.
Fix AI Lip Sync Mismatch in Generated Video
Mouth movements don't match your separately generated audio. Diagnose the cause and pick the right fix: re-render, post-sync, or compose around it.
Merge Conflict After AI Edits: Resolution Guide
Your branch plus AI edits conflict with main. Resolve it without losing the AI's real improvements, and stop mistaking format noise for logic conflicts.
AI Output Style Keeps Drifting — How to Pin It
Tone, voice, or format changes turn over turn even though the prompt is identical. Convert soft style descriptions into measurable rules the model can self-check.
AI Edits Broke package-lock / pnpm-lock — Fix the Conflict
An agent ran an install or removed deps and now your lockfile is at war with the team's. Throw it away and regenerate — here's the exact path per package manager.
AI Photo Realism Looks Plastic: Fix the Fake Skin Look
Photorealistic prompts come out looking plastic and fake. Fix it with concrete lighting, skin-texture, lens, and negative-prompt cues — verified June 2026.
AI Product Image Looks Fake / Doesn't Sell: The Fix
AI product shots read as fake when lighting is too symmetric, the contact shadow is missing, or reflections don't match the material. Here is the prompt-and-model fix path.
AI Refactor Created Duplicate Files: Safe Cleanup
Your agent wrote `UserList2.tsx` next to the original instead of editing in place. Diff, merge, delete, and fix imports without breaking the build.
AI Removed Working Logic During Refactor: Find It and Restore It
An AI agent "simplified" your code and quietly deleted a branch real users depend on. Bisect to the commit, cross-check prod logs, restore just the deleted hunks, and add a regression test.
AI Rewrote Critical Logic You Did Not Ask It to Touch
Asked for a one-line rename and got a retry loop, a timeout, and a forEach silently rewritten too. Here is how to scope an AI edit to a surgical, auditable diff.
Rolling Back AI Code Changes Safely
Undo bad AI edits without losing the good ones: pick the smallest git undo, and recover lost commits with reflog before the 30-day clock runs out.
Fix AI-Generated TypeScript Type Errors
AI code won't type-check (TS2322, TS2339, TS2554)? The exact tsc loop, error-code table, and agent rules that fix it in one pass.
Fix Garbled or Misspelled Text in AI Images
AI image text comes back as nonsense like RESPCT or OPEM. Pick a typography-strong model (GPT Image 2, Ideogram V3, Nano Banana 2) or add the text in post. Step-by-step fixes for June 2026.
AI Video Background Flickering: Causes and Fixes
Background strobes between shapes or styles. Fix it by simplifying the background, using one motion source, dropping Motion amount, or switching models.
AI Video Has Unwanted Camera Shake (Fix the Drift)
Static-shot prompts come back wobbling like a handheld iPhone clip. AI video tools default to gentle handheld motion. Force a locked frame with the right static clause, the camera control set to Static, and the motion slider at zero (plus a negative prompt in Kling/Hailuo).
AI Video Character Drift Across Frames
Same character, but their face morphs mid-clip. Lock one canonical reference, use the model's built-in character feature (Runway References, Kling Elements), keep clips short, and drop motion a notch.
AI Video Face Changes Mid-Clip: Stop Identity Drift
Frame 1 is your character, frame 90 is someone else. Anchor identity with a bound reference image, keep face-critical beats short, and drop motion. Fixes for Runway, Kling 3.0, Pika, Veo, Sora.
Image-to-Video Doesn't Follow the Source Image
Your output looks nothing like the input image. Raise image fidelity (Kling Relevance / CFG), cut the text prompt to motion-only, and feed a source at output resolution or larger with the subject filling 40%+ of frame.
AI Video Motion Doesn't Make Sense: 6 Causes + Fix Path
Legs pump forward but the body slides backward, water pours up, hands phase through objects. Verb is ambiguous and physics aren't simulated. Specify direction, target, and start/end pose.
AI Video Motion Jitter: Stop the Frame Popping
Limbs pop and subjects teleport between frames in Runway, Kling, Pika, or Veo. Fix it: one action per clip, anchor the start pose, render at native fps.
AI Video Has Too Much Motion: 6 Causes, 6 Fixes
Everything moves at once and the clip feels chaotic. Drop the motion strength, strip extra verbs, pick exactly ONE moving layer (camera OR subject), and add a static-camera negative prompt. Tool-by-tool settings for Runway, Kling, Pika, and Luma as of June 2026.
AI Video Pacing Feels Off: Fix It in the Edit
Clips drag or rush. Generate 2-4s clips, cut on beats with markers in your NLE, and vary clip lengths so it stops reading as a slideshow.
AI Video Product Object Deforms (Bottle, Box, Logo Warps)
Bottle stretches, packaging warps, logo bends in AI video. Treat product shots like macro photography: high-res reference, lowest motion, 5s clips, locked camera.
AI Video Scene Inconsistency Between Cuts
Same room prompt, two different sets? Anchor the scene with one canonical wide shot, a named location reference, identical lighting language, and a shared prop list — then color-match in post.
AI Video Subject Morphing Mid-Clip: Fixes That Hold Identity
Your subject starts as one person and ends as another. Fix it with a native character reference (Kling Element, Runway References, Sora Cameo), specific identity markers, and shorter shots.
AI Video Comes Out Too Static (Fix Under-Motion)
Your AI clip is a still with 5-pixel parallax. Add action verbs, name ONE camera move, and raise motion intensity — the three fixes for under-motion in Runway, Kling, Pika and Veo (June 2026).
AI Video Unnatural Physics: Why Things Fall Wrong (and How to Fix It)
Liquid pours sideways, cloth defies gravity, balls roll uphill. AI video models have no physics engine. Reframe the shot, switch to a stronger model, or composite real footage.
AI Image Composition is Weak / Boring: How to Fix It
Subject dead-center, no depth, no leading lines. Direct composition like you direct lighting: thirds placement, three planes, camera angle, depth-of-field cues.
Fix App Privacy Questionnaire Rejected / Inconsistent
App Store Connect flagged your privacy nutrition labels as inconsistent with app behavior. The fastest fix: build an SDK-to-data-type inventory and reconcile every answer before resubmitting.
App Rejected for Guideline 4.3(b) — Design Spam (2026)
Apple's 4.3(b) hits template farms, re-skins, and thin AI-wrappers. Either differentiate substantively or build an evidence-backed appeal — rewrites rarely reverse it.
App Review Demo Account Fails: The Guideline 2.1 Fix
Apple rejects your build with 'We were unable to sign in with the credentials you provided' but the account works on your phone. Six causes ranked by hit rate, with the exact App Store Connect Sign-In fields and resubmit steps.
Rejected for Guideline 2.1 Information Needed: Fix in One Resubmit (2026)
Apple's Guideline 2.1 rejection is a documentation gap, not a code bug. Fill the demo-account fields, turn on your backend, and resubmit, usually with no new build.
Astro Pages 404 After Deploy
Pages work in dev but 404 in prod — almost always a build.format, trailingSlash, or output-mode mismatch with the host. Copy-paste fix path.
Auth Redirect Returns to the Wrong URL (redirect_uri_mismatch)
Sign-in redirects to localhost or the wrong domain, or the provider errors with redirect_uri_mismatch. Add the exact callback URI to the allowed list and drive it from env.
Canonical Still Points to Old Domain After a Move
Moved to a new domain but pages still emit the old canonical — fix hard-coded URLs, CDN cache, sitemap, 301s, and Search Console.
Fix Canonical URL Mismatch on a Bilingual Site (EN/ZH)
Search Console indexes the wrong language because your EN/ZH canonicals point at each other. Fix: make every locale self-canonical and let hreflang declare the alternates.
ChatGPT Account Switch Not Working: 5 Causes + Fixes
Switched accounts but ChatGPT still shows the old one. Usually the native 2-account switcher cap, a cached session cookie, SSO auto-select, or a Business workspace lock.
ChatGPT App and Web Out of Sync: Why, and the Fast Fix
A conversation shows on the web but is missing in the app (or vice versa)? The cause is almost always a mismatched account or workspace, not lost data. Here's how to find which one in under two minutes.
ChatGPT Blank Screen After Login
Login completes, ChatGPT redirects to chatgpt.com, then a white page. Fix it fast: hard refresh, unregister the service worker, clear cache, disable extensions, check JS policy.
Cookies Blocked: Fix ChatGPT Login Failures
Blocked third-party cookies break OpenAI's login handshake and trigger a Cloudflare loop. Exact per-browser toggles to sign in again, verified June 2026.
ChatGPT Misreads Your CSV / Excel Data File
Numbers come back wrong, headers misaligned, dates flipped. Force the analysis tool, declare your locale, and verify row counts — accurate results in three steps.
ChatGPT File Analysis Feels Too Shallow
You asked for analysis and got bullet points anyone could write without opening the file. The fix is prompting for evidence, not switching models.
Uploaded File Disappears From a ChatGPT Conversation
You uploaded a file, asked a question, and the file is gone. Since the March 2026 Library, most uploads are recoverable — here's how to find them and stop it recurring.
ChatGPT File Type Unsupported: Workarounds That Actually Work
ChatGPT rejects your file or says it can't analyze it. Identify the real type, then convert to a known-good format. Conversion beats fighting the upload.
Fix ChatGPT File Upload Not Working: Size, Format, Region, Extensions
ChatGPT file upload stuck at 0%, fails after the bar finishes, or uploads but says 'can't read'? Different problems, different fixes. Verified limits and 9 causes for June 2026.
ChatGPT Generated File Download Failed: Fix the Expired Link
ChatGPT made a file but the download 404s, hangs, or comes back empty (often The code interpreter tool session has expired). Diagnose and fix it fast.
Custom GPT Won't Load or Action Fails — Fix It Fast
Click a Custom GPT and get a blank screen, or its action returns 'request failed'? Nine times out of ten it's cache, account access, or the creator's action backend. Here's how to tell which.
ChatGPT History Missing? Recovery Checklist (June 2026)
Sidebar empty? 9 times out of 10 the chats aren't gone — wrong account, Temporary Chat, archived, or a stale tab. Walk this checklist before assuming loss.
ChatGPT Image Generation Fails — 5 Causes, Ranked
Image won't generate? Safety filter, quota, prompt conflicts, or capacity throttle — diagnose in 30 seconds with a minimal probe, then fix the right branch.
ChatGPT Misreads Your Uploaded Image: 7 Causes and Fixes
ChatGPT describes your screenshot or chart wrong. Fastest fix: re-upload a sharp PNG (long edge 1500px+), crop to the region, then give a directed transcription prompt.
ChatGPT Skims a Large Document: How to Force Full Analysis
Uploaded a 200-page report, but the summary reads like it only saw 30 pages. ChatGPT runs retrieval, not full reading. Force depth with chunked, page-anchored queries.
ChatGPT Login Loop — Signed In, Bounced Back to Login (2026 Fix)
Credentials and SSO succeed but the page bounces back to login or the Cloudflare check. 90% of the time it's cookies, a rotating VPN IP, or a stale session. Here's the exact order to fix it.
ChatGPT Login Works in One Browser but Not Another
Chrome works, Safari fails (or any other pair). The account is fine — the difference lives in cookie policy, extensions, stale SSO state, or browser version.
ChatGPT Memory Not Working: Why It Forgets and How to Fix It
ChatGPT says "got it" then forgets next session? It's usually a toggle, Temporary Chat, a write that never happened, or the new background memory. Check these and fix it.
ChatGPT Message Cap Hit: What Actually Resets
Hit the "You've reached your limit" wall in ChatGPT? Here's what the rolling cap really means, the fastest way back to work, and how to stop hitting it.
ChatGPT Mobile App and Web Login Mismatch: Fix It
Same email but the ChatGPT app and web act like different accounts. The three real causes are workspace, SSO method, and App Store subscription — here's how to tell them apart and fix it.
ChatGPT Won't Cross-Reference Multiple Files
Uploaded 3 files for comparison but ChatGPT only reads one? Name every file and force a per-file table. Verified for GPT-5.5, June 2026.
ChatGPT Network Error: 8 Real Causes and the Fix for Each (2026)
ChatGPT showing 'network error' or 'There was an error generating a response' mid-message? It's one error surface for eight different problems. Triage in 30 seconds, then fix the exact cause.
ChatGPT Password Reset Email Not Arriving
Forgot password and nothing came? It's a different flow from signup verification — stricter rate limit, SSO-only and passkey-only accounts are silently rejected. Here's the fastest fix.
ChatGPT PDF Analysis Not Working — File Reads Empty
Upload a PDF and ChatGPT says it sees nothing or 'No text could be extracted' — almost always scan-vs-text, size, or encryption. Fastest fix inside.
ChatGPT Project Files Not Being Referenced
You uploaded files to a ChatGPT Project but the model answers as if they don't exist. Fastest fix: name the file in your prompt and force a quote. Full diagnosis below.
ChatGPT Project Instructions Ignored: Why and How to Fix It
You wrote detailed Project instructions and ChatGPT keeps ignoring them mid-conversation. It is almost always instruction weight, a conflict with your current message, the 1,500-char field limit, or Memory overriding the rule. Here is the fix.
ChatGPT Project Context vs Chat Context — Why They Diverge
Set instructions and files in a Project but a chat ignores them, or one chat 'remembers' another? Map the five context layers and fix the leak fast.
ChatGPT Session Expired Every Few Minutes: 8 Fixes
ChatGPT keeps logging you out mid-chat? The 3 main causes are cookies being wiped, multiple tabs racing the token, and a corporate proxy stripping headers. Verified June 2026 fixes.
ChatGPT Shared Link Not Opening: Causes and Fixes
A chatgpt.com/share link 404s or shows blank? It's almost always sharer-side — deleted, policy-removed, or never created. Here's how to tell which, fast.
ChatGPT Got Slow: What to Check First (June 2026)
ChatGPT replies crawling? It is almost always a long conversation, a heavy model, or network RTT — in that order. Start a new chat first; it fixes most cases.
ChatGPT Shared Link vs Account Login: Where the Line Is
A ChatGPT shared link is a public read-only snapshot, not a login. Here's what the URL does, why you can't reply, and how to share or revoke one safely.
ChatGPT Stuck on Loading: 6 Reasons It Spins Forever (2026 Fix)
ChatGPT shows a spinner or 'thinking' that never returns? It's not one issue, it's six. Run this 1-minute triage to find the right fix and stop the spinning.
ChatGPT "Unusual / Suspicious Activity Detected" — Unlock Path
It's almost always your egress IP, not your account. Switch network, wait for the cool-down, re-login. Full diagnosis below.
Uploaded PDF Not Analyzed Correctly in ChatGPT
PDF uploaded fine but ChatGPT misses tables, skips pages, or invents numbers. The fix is almost always the extraction layer, not the model. Step-by-step diagnosis with current limits.
ChatGPT Verification Email Never Arrives: 7 Checks That Fix It
Signup link or login code not coming? Spam, a typo, an alias filter, corporate ATP, a VPN, or regional throttling — here's how to find which one and fix it fast.
ChatGPT Voice Not Working: Fix It in Minutes (2026)
Voice silent, stuck on Connecting, or the waveform button missing? It's almost always microphone permission, the wrong input device, a stale build, or the retired macOS-app voice.
ChatGPT Web Search Not Working / Won't Trigger (June 2026 Fix)
ChatGPT search spins forever, returns no sources, or refuses to browse? Here's how to force it, plus the six reasons it silently fails.
ChatGPT Wrong Authentication Method After Signup
You signed up with Google but try email + password (or the reverse). ChatGPT refuses and it looks like a wrong password. Here is how to find the real method.
Claude Artifact Download Fails or Saves an Empty File
Artifact download does nothing or drops a 0-byte file. Fix it: wait for the stream to finish, disable blockers, or have Claude paste the content.
Claude in Chrome Not Reading the Page: 6 Fixes
Claude in Chrome shows connected but says it can't see the page? Fix per-site permission, SPA/Canvas pages, wrong active tab, and the Cowork conflict.
Claude Code Keeps Asking Too Many Questions
Claude Code stops every few seconds to ask permission or to ask "TypeScript or JavaScript?" Two different problems, two fixes: a permission mode for tool prompts, CLAUDE.md defaults + Proactive style for decision questions.
Claude Code Lost Project Context Mid-Task
Agent forgets earlier decisions, re-reads CLAUDE.md, contradicts the plan. Auto-compact dropped the load-bearing details. Run /rewind, re-anchor, or restart with a tight handoff.
Claude Code Does Not Understand Your Project — Fix It
Claude Code re-edits the same file or ignores whole workspaces? Run /init, anchor it with CLAUDE.md, and start from the repo root. Verified June 2026.
Claude Code Ignores Your Audit Report
You fed Claude Code a detailed audit and it did its own thing. The report is context, not a contract — convert it to numbered Tasks, execute one at a time, and diff progress against the original list.
Claude Code Misunderstands Your Project Architecture
Claude Code suggests "extract this into a microservice" when you're intentionally monolithic. Fix it with explicit do/don't rules in CLAUDE.md, path-scoped .claude/rules/, and a PreToolUse hook that hard-blocks drift.
Claude Code Output Does Not Match Your Prompt: Fix the Plan, Not the Diff
The diff is polished code for the wrong feature. Catch the divergence at the plan stage with Plan Mode (Shift+Tab) and a restate-before-execute step, not after the code lands.
Claude Code Overwrote My Uncommitted Changes: Recover With /rewind + Local History
Two hours of uncommitted edits gone after the agent ran. Try /rewind first, then editor local history and reflog — then lock it down with commit-before-agent, deny rules, and worktrees.
Claude Code Plan Mode Diverges From the Plan
You approved a 5-step plan; Claude did 7 steps, skipped one, and refactored adjacent code. Bind execution to the approved plan with file-anchored steps + post-step status checks.
Claude Code Refactor Scope Becomes Too Broad
Asked for a one-file rename, got a 12-file diff? Enforce the boundary with a permissions deny rule, scope every prompt with an editable-file list, and park adjacent issues in FOLLOWUPS.md.
Claude Code Stopped Mid-Task: Which Usage Limit You Hit and How to Resume
Claude Code halts a refactor with 'usage limit reached.' Tell apart the 5-hour window, the weekly cap, and the separate Opus cap, save state, and resume without redoing work. Verified for June 2026.
Claude Code Stuck After Partial Execution
Claude Code did 60% of the task then went silent — no error, no completion. Diagnose which of three flavors (context compaction, tool hang, dropped stream) and recover without redoing work.
Claude Code Stuck in a Loop — How to Break Out
Claude Code repeats the same edit, oscillates between two files, or chases a flaky test forever. Six loop signatures, the one-prompt fix for each, and the exact Esc / rewind / clear / Stop-hook commands to recover. June 2026.
Claude Code Edited the Wrong File
Claude Code changed a file you didn't intend (lookalike name or it followed an import chain). Revert with git, then lock the boundary with permissions.deny Edit rules in .claude/settings.json.
Claude Connector "Permission Denied": Fix It or Ask Admin
A Claude connector refuses to authorize or returns empty data. Diagnose the four locks: workspace policy, OAuth scope, target-app admin policy, and token state.
Why Claude File Generation Burns Your Limit So Fast
Generating files in Claude costs far more of your usage limit than chatting. Here is how it's counted and six ways to conserve, verified June 2026.
Claude GitHub Connection Failed: No Repos / Access Denied Fix
Claude's GitHub connector shows no repos or 'access check failed'? Fix it: install the GitHub App on the right account, select the repo, and clear org approval.
Claude Gives Confidently Wrong Answers: How to Fix It
When Claude returns a confident but inaccurate answer, switching models rarely helps. Grounding, system-prompt rules, and a fresh chat fix most cases.
Claude Long Conversation Becomes Unstable: How to Reset
After 50+ turns Claude contradicts itself or forgets decisions. Why it happens, how to spot which cause you have, and the fastest reset that fixes it.
Claude 429 Rate-Limit Retry Loops: Stop the Hammering and Fix It
Claude keeps looping on 429 rate_limit_exceeded — read retry-after, cap concurrency, separate 429 from 529, and stay under your tier's RPM/ITPM/OTPM.
Fix Claude Tool / Connector Showing "Unavailable"
A Claude tool greys out or shows "unavailable in your workspace." Triage status, plan, and admin policy in the right order to get it back fast.
Codex Audit Report Is Too Broad to Act On
Asked Codex to audit your project and got a 50-bullet report mixing typos with architecture? Re-scope to one dimension, cap output, force file:line, use /review's custom-instructions preset.
Codex Cannot Finish a Patch Cleanly
Codex says "done" but leaves broken imports, half-converted types, and untouched call sites. Bind "done" to a verifier in AGENTS.md, then check the exit code yourself.
Codex Duplicates Files Instead of Editing Existing Ones
Codex creates `utils.v2.ts` next to `utils.ts` instead of editing in place. The real cause is an apply_patch Update→Add fallback. Force in-place edits with AGENTS.md rules, git, and the right sandbox mode.
Codex Fails to Run or Interpret Build Results
Codex skips the build, misreads it, or trusts a truncated tail. Fix it with exit-code checks, machine-readable verifiers, and a Stop hook gate — not prose summaries.
Codex Fixes One Bug But Breaks Nearby Logic
The reported bug is gone, two adjacent features regressed. Cap blast radius, enumerate call sites, prefer caller-side guards over shared-util changes.
Codex Ignores Your Project Structure: The AGENTS.md Fix
New files land in /src/ when your repo uses /app/; deps go to the root package.json in a monorepo; tests use a framework you don't have. Fix it with a root AGENTS.md, nested overrides, and canonical-example pointers — verified against Codex behavior, June 2026.
Codex Makes Unsafe Assumptions
Codex uses a column, env var, or function signature it never read. Force a quote-before-write rule and run Codex read-only so it grounds every line in your real files.
Codex Misses Project-Specific Conventions: Fix With AGENTS.md
Codex writes `getUserById` when your codebase uses `findUserById`. Codify each convention as rule + a canonical example file in AGENTS.md, then verify it loaded.
Codex Patch Conflicts With Existing Code
Codex fails with "Invalid Context" or "No such file or directory" when applying a patch. Tell the two apart, then refresh state or restart the session.
Codex Code Review Feels Too Shallow? Fix It
Codex review returns generic bullets like "consider error handling." Fix it with the built-in /review command, AGENTS.md review guidelines, and file:line-anchored prompts.
Codex Code Does Not Match Your Codebase Style: The Fix
Functionally correct but reads like a stranger wrote it: async/await mixed with .then(), wrong import order, off comment style. Anchor Codex to a canonical file in AGENTS.md, then enforce the rest with lint.
Codex Test Suggestions Are Too Generic
"Test the happy path and error path" is useless filler. Force Codex to bind tests to the real function signature, the actual types, edge cases, and bug history.
Codex Output Doesn't Match Project Structure
Codex puts files in the wrong place or ignores your conventions. Constrain it with AGENTS.md, a sibling-file reference, and plan-first prompting.
AdSense Cookie Consent: The Minimum That Keeps Ads Serving
EEA/UK/Switzerland need a Google-certified TCF v2.3 CMP; US states need a Do-Not-Sell link. The fastest compliant setup, plus how to verify it.
CORS Error Calling Your Own API: The Fix
Browser blocks your fetch with a CORS error while curl works. Diagnose the real cause and fix it server-side, with verification.
Cursor "Apply" Silently Failed
You hit Apply, Cursor says it's done, but the file never changed — usually a stale snapshot, an outside edit, or a locked file.
Cursor Won't Apply Edits: 6 Causes and the Fix
Cursor shows a diff but Apply does nothing, fails silently, or says the apply model made no changes. Fastest fix: save all files, close other editor windows, then Reapply.
Fix Cursor Composer Losing Context in Large Monorepos
Composer is sharp in a small repo and loses the thread in a 50k-file monorepo. Force focus with @Files, MDC rules, and scoped tasks — not heroic re-indexing.
Cursor Composer Made Sweeping Wrong Edits
Composer rewrote 10+ files and broke working code. Revert fast with a Cursor checkpoint or git, then bound the prompt and mode so it stays surgical.
Cursor Config Conflicts with VS Code Workspace Settings
Open a team repo and Cursor's formatting or AI behavior changes? The repo's .vscode/settings.json is overriding your user settings. Here's how to find which layer won.
Cursor Context Panel Missing the File You Expected
The Cursor context panel skips the file you know is relevant. Fix it in 5 seconds with @, then stop it recurring: check .cursorignore, resync the index, and rename generic files.
Cursor Diff Too Large to Review
Composer dropped a 30-file, 2000-line diff and you can't review it honestly. Reject (or restore the checkpoint), then make Composer split it into reviewable PRs.
Cursor Edit Applied but Build Breaks
Composer says done and the touched files lint clean, but the build fails. The fast fix: turn on Auto-run so the agent runs typecheck + build itself before declaring success.
Cursor Generates Duplicate Logic Instead of Reusing Helpers
Cursor wrote a new formatDate but src/utils already has one. The existing helper never reached retrieval — here is how to make Cursor grep first and reuse it.
Cursor IDE State Out of Sync with Disk
Editor shows old code after an AI edit, save says "file modified externally", or AI changes silently revert — the watcher / AI-write race, and how to fix it without losing work.
Cursor Indexing Never Completes: 7 Causes and Fixes
Cursor's index spinner runs for hours with no progress. Usually it's a bloated repo, a missing .cursorignore, a corporate HTTP/2 proxy, symlink loops, or permissions. Here's how to find which one.
Cursor Missed the Full Project Context
Cursor only edits files it can see. Fix indexing scope, open the right workspace root, and pin files with @ references.
Cursor Chat Reads the Wrong File
You @ one file and Cursor answers about a different same-named file. Fix the @-picker, stale index, and symlink causes with full-path references and a resync.
Cursor Keeps Reading the Wrong Files
Cursor pulls old, vendored, or generated files into context and produces wrong patches. Fix the index, .cursorignore, and prompt pinning.
Cursor Suggestions Don't Match Repo Conventions
Tab and Composer use different naming / formatting / patterns than your repo — training prior beats retrieval; anchor explicitly.
Cursor Tab Suggestions Stopped Appearing
Grey inline completions vanished in Cursor? Re-enable Tab, check sign-in/quota, kill Copilot's keybinding, switch to HTTP/1.1, or clear the cache. Step-by-step, verified June 2026.
Cursor Agent Terminal Command Behaves Unexpectedly
Cursor's agent runs a shell command and gets it wrong — wrong working dir, wrong package manager, env not loaded, output truncated, or .zshrc hangs the run. Concrete fixes.
Custom Domain SSL Stuck on Pending: The Real Fix
SSL pending for hours after adding a domain on Vercel/Cloudflare/Netlify? It's almost always DNS, a CAA record, or a blocked HTTP-01 challenge. Here's the order to check.
Deploy Succeeded But Page Shows Old Content: Fix
Vercel / Firebase / Cloudflare say the deploy shipped, but visitors still see yesterday's HTML. The 5 ranked causes and a 10-minute client-to-origin diagnostic.
I Changed DNS But the Site Still Won't Load
Updated DNS but the site shows the old IP or won't load? Verify with dig, check the active nameservers, flush local + browser cache, and wait out the TTL. Step-by-step, as of June 2026.
DNS Propagation: Why Regions See Different IPs (and How to Verify)
You changed DNS and some users see the new IP, some the old. Here's why regional inconsistency is normal, plus a measurable fix and verification path.
Edge Function Timeout: Vercel / Cloudflare / Netlify Fix
FUNCTION_INVOCATION_TIMEOUT or 504 on edge? Move heavy work off edge, stream responses, and timeout every upstream fetch. Verified limits, June 2026.
Environment Variable Missing in Production: 5 Causes + Fix
Works locally, fails in prod. Env var not set on the host, or wrong client prefix (PUBLIC_ / VITE_ / NEXT_PUBLIC_). Diagnose and fix in ~10 minutes.
Fix Firebase Deploy "Permission Denied" (403)
firebase deploy fails with 403 or "caller does not have permission"? Diagnose the identity chain — account, project, IAM roles, CI auth — and fix it fast.
Firebase Function Not Found: Fix the Region/Name/Deploy Mismatch (2026)
A callable returns "not found" even though the console shows it. Diagnose region, name, and deploy state in minutes.
Firebase Hosting Deploy Fails
Fix firebase deploy --only hosting: CLI version, expired auth, wrong public path, or Spark quota.
Firebase Hosting Rewrites Not Firing (2026)
Your firebase.json rewrites for an SPA or Cloud Function don't trigger. Fix the order, region, and deploy target in minutes.
Gemini on Android Not Replacing Assistant
Tap-and-hold power doesn't bring up Gemini on Android — toggle, app version, region.
Gemini App vs Web Show Different Conversations
Same Google account, different chat lists on the app vs gemini.google.com. Account mismatch, the 2026 sync-overwrite bug, Keep Activity, and Workspace policy explain almost all of it.
Gemini Deep Research Returns Thin, Shallow Results
Deep Research output is shallow or one-sided? Fix it with scope, source filters, and follow-up drills — plus the new Deep Research Max (Gemini 3.1 Pro).
Fix Weak, Generic Gemini Document Summaries
Gemini summaries miss key numbers and skip risk sections? Tell it what to extract and how to structure it. Tested prompts, model-picker fix, and verification steps for June 2026.
Gemini Share / Export Not Working
Gemini Share button grayed or missing, shared g.co/gemini/share link 404s, or Export to Docs fails. Fix by tier, Workspace policy, and source-conversation state.
Gemini File Upload Fails or Returns Wrong Content
File attached but Gemini can't see it, or the summary is wildly off? Fix size caps, format, Drive access, and scanned PDFs.
Fix Gemini Google Account Permission Errors (Gmail / Calendar)
Gemini says "Permission denied" or can't access your account? Re-connect the app, turn on Gemini Apps Activity + Gmail Smart features, and clear Workspace policy.
Gemini Image Generation Unavailable or Refusing
Gemini won't generate an image, has no Create image button, or says 'I can't generate that image' — fix the safety filter, region, tier, and Workspace gates.
Gemini Not Responding: Fast Triage (June 2026)
Gemini spins forever or returns a blank card? Work through account, network, browser, and Workspace gating in order — most cases clear in under five minutes.
Gemini Quota Exceeded / Feature Unavailable Today
Gemini says "try again later" or "feature not available." Almost always quota or tier, not an outage. Here is how to tell which, and the fastest fix.
Gemini Side Panel Missing in Workspace (Docs/Gmail) 2026
No Gemini side panel in Docs or Gmail? Check edition, the admin Feature access toggle, and Smart features. Fix order inside.
Gemini Replies in the Wrong Language
Ask in Chinese, Gemini answers in English (or vice versa). Lead your prompt with 'Reply in Chinese' for an instant fix, then align account and browser language so it sticks.
Recover an Old File Version After a Bad Git Commit
You committed over code you needed, or reset --hard the wrong commit. The fix: most of the time the objects are still in your repo. Start with `git log -p --follow -- <file>`, or `git reflog` if a whole HEAD vanished.
Google Rewrote My Title — How to Get the Original Back (2026)
Google replaced your title tag with a shorter or different one in search results. Diagnose which signal triggered the rewrite and fix it — with current 2026 length budgets and the new AI-headline behavior.
Hreflang Errors in Search Console: Where They Went and How to Fix Them
Google retired the International Targeting report in 2022, so hreflang errors no longer show in Search Console. Here is how to find No return tags, invalid language code, and 404 target errors with a crawler instead, and how to fix each.
IAP Sandbox Purchase Fails: The 7-Point Diagnostic Order
Sandbox IAP has seven moving parts that must line up: the device Sandbox Apple Account, region, App Store Connect agreements, product status, bundle ID, capability, and StoreKit config file. The diagnostic order, current for iOS 18+ and Xcode 16 as of June 2026.
How to Inspect AI-Generated Diffs Before Accepting
A 200-line Claude Code or Cursor diff isn't safe just because it compiles. Read it deletions-first, in the right order.
Works Locally, Fails in Production: The Fix Checklist
Works on localhost, breaks on Vercel / Render / Cloudflare Pages. Reproduce the prod build locally, diff env vars, pin the Node version, and fix Linux case-sensitivity — the systematic checklist.
Long Prompt Makes the Answer Worse: How to Fix the Shape
Your prompt is detailed and exhaustive, yet the answer is vague, off-target, or generic. Here is why long prompts dilute, and the structural fixes that work.
Why Longer Prompts Give Worse Results: 5 Fixes (LLM Length Paradox)
Your 500-word super-prompt scores worse than a 100-word one. Here's why long prompts degrade output, plus 5 fixes that work as of June 2026.
Google Replaced My Meta Description in Search
Google shows its own snippet instead of your meta description. Find which of 7 triggers your page hits and rewrite to win the snippet back.
Multi-Agent Conflict: Two Agents Edited the Same Files
Claude Code + Codex (or two parallel sessions) edited the same function and produced a merge conflict. Isolate scopes with git worktrees, abort the broken merge, and resolve as a human — never let an agent merge.
Two AI Agents Edited the Same File: Clean Merge
Cursor and Claude Code clobbered the same file. Stop both, recover each intent, merge by hunk, and isolate agents with worktrees so it never repeats.
MX Records Got Overwritten — Inbound Email Broken
After a DNS change your MX disappeared and mail stopped arriving. Diagnose the exact case and restore the correct records for Google Workspace, Microsoft 365, Zoho, Fastmail, or Proton.
OG Image Not Showing When You Share a Link (Fix Checklist)
Slack, X, LinkedIn, or Facebook unfurls your URL with no preview image. The 7 real causes and the exact debug commands and cache-refresh tools.
OG Image Not Appearing on Social Shares
Share to LinkedIn / X / Slack and no image shows. Fix the meta tag, image size, or cache in minutes.
Prompt Triggered an Unexpected Refusal — How to Reframe
A legitimate task got refused or half-answered by the safety system. Here is the fastest reframe, a trigger-word swap table, and which model to switch to (June 2026).
Fix External API 429 Rate Limit Errors
Stripe, Twilio, and SendGrid all return 429 once traffic ramps. Read the rate-limit headers, add exponential back-off with jitter, cache idempotent GETs, dedupe concurrent calls, and batch writes — in that order.
Redirects Not Working After Deploy: 6 Causes + curl Fix
Your vercel.json / _redirects 301 deployed but fires a 404 or the old page. Diagnose with curl -I across Vercel, Netlify, and Cloudflare Pages — file location, rule order, file shadowing, CDN cache, trailing slash, rewrites vs redirects.
robots.txt Not Taking Effect
You changed robots.txt but Google still crawls or indexes the same URLs. The fix is almost always a cache layer or a duplicate file — here is how to find which one.
RSS Feed Returns 404 — Fix /rss.xml Missing on Deploy
Your /rss.xml or /feed.xml 404s: the endpoint isn't in the build, the filename mismatches the link tag, or a host rewrite is hiding it. Per-stack fixes for Astro, Next.js, Netlify, Vercel.
sitemap.xml Not Found (404) — Astro Integration / Site Fix
/sitemap.xml or /sitemap-index.xml returns 404, or Search Console says 'Couldn't fetch'. Five ranked causes with checks you run against dist/.
SSL Certificate Stuck Pending After Custom Domain Setup
You bound a custom domain on Vercel / Firebase / Netlify but SSL stays "pending." Diagnose DNS, CAA, and Cloudflare-proxy causes and fix it fast.
Static Assets 404 After Deploy (Astro/Vite Fix)
Images, CSS, and fonts 404 in production but work locally. Five web-verified causes and fixes: missing dist/ copy, base path, case mismatch, content hash, CDN cache.
Static Site Renders a Blank Page: Find the Cause in 10 Minutes
Production URL loads to an empty page with no UI error. Open DevTools before navigating, read the first red console line, and map it to the fix — base path, hydration, CSP, build target, or a stale Service Worker.
Object Storage Upload Denied (S3 / Firebase / Supabase 403)
Fix S3, Firebase Storage, and Supabase Storage upload 403s — IAM permission, signed-URL expiry, bucket policy, or disabled-ACL gotcha.
Fix Rich Results Test Warnings and Errors (JSON-LD)
Rich Results Test shows your JSON-LD has warnings or invalid fields. Tell errors from warnings and fix each one.
Subdomain Not Resolving: blog.example.com Won't Load
Your apex domain works but blog.example.com gives NXDOMAIN or an SSL error. The fix is almost always a missing DNS row or a domain you forgot to attach at the host. Diagnose it in five buckets.
Suno Extend Sounds Off / Clipped: Fix the Seam
Suno Extend continues from the audio at your cut point plus the style text, not the song's identity. The cut-point, style-lock, and Get Whole Song fixes that smooth the seam.
Suno Instrumental Doesn't Match the Mood (Fix)
Sad lyrics, upbeat backing? Put mood, tempo and key in the Style of Music field, add Exclude Styles, and raise Style Influence.
Suno Ignoring Your Lyrics? Custom Mode Fix
You wrote lyrics, Suno sang something else. The fix is Custom Mode plus bracket structure tags and matching lyric length to song length.
Suno Outro Ends Awkwardly: Fix the Abrupt Stop or Ugly Fade
Suno slam-stops mid-phrase or does a 3-second fade. Fastest fix: end your lyrics with an `[Outro]` instruction plus an `[End]` tag on the very last line, then use the in-app Fade Out tool. Full causes, templates, and verification inside.
Suno Song Structure Feels Weak: Fix the Flat Arc
Suno song stays at one energy with no chorus payoff? Add structure tags in the Lyrics field plus dynamics words in Style. Templates, ratios, and the v5.5 editor fix.
Suno Style Descriptors Being Ignored
Your "synthwave, retro, 80s synth" prompt gives a piano ballad. Why Suno drops style words, and the fixes that stick (v5.5, June 2026).
Suno Song Too Repetitive — Same Chorus 6x Fix
Suno repeats the chorus byte-for-byte because your lyrics repeat. Break the loop at three layers — lyrics, melody hints, structure tags — or patch one section with Replace.
Suno Mispronounces Chinese (and Other Languages): Fixes
Suno mangles Mandarin polyphones, tones, and mixed-language lines. Fastest fix: generate on v5.5, respell problem words in your lyrics before generating, and keep lines short. Full diagnosis + fix path.
Fix Robotic-Sounding Vocals in Suno (v5.5)
Suno vocals sound like cheap TTS — stiff, no breath, no soul. Strip synthetic style words, request natural breath, and fix line phrasing to get human vocals.
Suno Outputs the Wrong Genre — Style Ordering Fix
You wrote lo-fi hip-hop in Style and got generic pop. Fix it by putting the genre first, adding a BPM, and using the Exclude Styles field to strip conflicting instruments.
Supabase Env Vars Undefined in Production: The Fix
Supabase URL or anon/publishable key is undefined after deploy — fix the host env config, framework prefix, stale build, and the 2026 key migration.
Supabase RLS Returns an Empty Array (No Error)
Your Supabase table has rows but the frontend gets [] with no error. Diagnose which RLS bucket you're in and add the right SELECT policy in minutes.
TestFlight Build Stuck in "Processing" — How to Unstick It
Your TestFlight build has shown "Processing" for hours. Here are the 8 real causes and an exact checklist to unstick it, current as of June 2026.
Trailing Slash Mismatch: Fix the Double-Redirect Loop
/foo 308s to /foo/ then 308s back to /foo. One rule across framework, host, and links kills the redirect chain. Astro/Vercel/Next.js config included.
Vercel 500 Errors: Find the Real Cause Fast
Build is green but production 500s. Diagnose FUNCTION_INVOCATION_FAILED, missing env vars, Edge runtime, and timeouts with real vercel logs commands.
Vercel Deploy Stuck on "Building"
Build sits at "Building" with no new logs. Cancel it, read the last log line, then fix the real cause: a hung fetch in static generation, an install deadlock, OOM, or a postbuild hook.
Webhook Not Firing: Provider Says 200, Your Endpoint Is Silent
Stripe, GitHub, or Shopify says the webhook was delivered but your server never sees it. Read the delivery log, find the status code, and fix the real cause.
When to Apply for AdSense — Readiness Checklist (2026)
Apply too early and collect a 'low-value content' rejection; too late and you lose months of revenue. Run this 6-signal readiness check first.
www and Root Domain Don't Match (Only One Loads)
www.example.com works but example.com returns an error (or vice versa). Fix the missing DNS record, then add a 301 redirect to one canonical version.
AdSense "Low Value Content" Rejection: What It Means and How to Recover
Decode the most common 2026 AdSense rejection — what reviewers actually check, how Information Gain and E-E-A-T factor in, and a four-week recovery plan that works.
"Crawled — Currently Not Indexed" — What It Actually Means and How to Fix It
Google crawled your page and decided not to index it. The reasons are almost always quality, duplication, or authority — not technical. The real fix list.
Discovered Not Indexed: A New Indie Site's Playbook
Why Google parks new indie-site URLs in 'Discovered — currently not indexed,' and the multi-week playbook that actually moves them: internal links, crawl budget, content depth, and a realistic timeline (June 2026).
Google Won't Crawl Your New Pages: The Diagnostic Checklist
A reproducible checklist for when you publish a page and Google ignores it. Run the steps in order, stop at the first failure. Verified for June 2026.
How Long a Domain Really Takes to Propagate (2026)
"24 to 48 hours" is folklore. Modern DNS record edits go live in minutes. If yours hasn't after 30 minutes, something is misconfigured — here's how to prove which.
Search Console URL Inspection: How to Read It Right
URL Inspection shows what Google has stored, when it last crawled, and why a page is or is not indexed. Read every field correctly, plus the API call to inspect in bulk (June 2026).
ChatGPT Won't Open: A 6-Step Triage (Region / DNS / Cloudflare)
ChatGPT shows a blank page, hangs on a spinner, or returns access denied? Work this 6-step triage in order: status page, incognito, extensions, DNS, VPN node, device.
ChatGPT Login Fails: Email, Google SSO, OTP, and Suspicious Activity
ChatGPT login failures fall into four buckets: email-password bounce, Google/Microsoft SSO error, the new 6-digit OTP code never arriving, and a suspicious-activity lock. Find your bucket, get the shortest fix.