AI Programming Manual

Guides, tutorials, and tools for building software with AI — whether you write code professionally or build by describing what you want.

Where should I start?
News Aug 24 2026

OpenAI Regional Processing Per Request: Route One Call to the EU

One Global-project API key can now select global, US, or EU processing per request. The base-URL change, eligibility gates, support matrix, and negative tests to add before rollout.

8 min read
OpenAI API · Regional Processing · Data Controls
News Aug 23 2026

Computer Use Goes GA — and the Browser Toolset That Reads the Page Instead

The GA toolset rejects five parameters the beta tool accepted, and coordinates move into the screenshot you return. Plus when to address elements by reference instead of by pixel.

9 min read
Claude API · Tool Use · Migration
News Aug 22 2026

Anthropic Python SDK 1.0: The Migration That Removes temperature, top_p, and top_k

Version 1.0 raises the Python floor to 3.10 and swaps httpx for httpx2. Apply the five breaking changes in order, and check your mocks before you trust a green test run.

8 min read
Python · Anthropic SDK · Migration
News Aug 21 2026

Private Claude Code Plugin Marketplaces: Short-Lived Auth with headersHelper

Claude Code 2.1.238 can mint HTTP headers for private URL marketplaces and plugin archives. Choose catalog or entry scope, preserve confirmation, and test every fetch path.

9 min read
Claude Code · Plugins · Security
News Aug 20 2026

The Claude API Beta Headers That Just Went GA: What Removing Them Changes

Files, Skills, and Enterprise user management are GA on the Claude API. Two of the three beta headers are free to delete; the third quietly changes the shape of every GET /v1/files response.

11 min read
API Contracts · Claude API · Files API
Article Aug 19 2026

Resume an Agent Run After a Crash: Checkpoints, Durable State, and Safe Replay

A dead run should restart at the step it reached, not at step one. The checkpoint record, the three replay classes, commit order around external effects, and the kill test that proves it works.

20 min read
Reliability · Agents · Durable state
News Aug 18 2026

OpenAI's Assistants API Shuts Down August 26: The Migration Checklist

Assistants, threads, and runs map onto the Responses and Conversations APIs. Where the retention floor moves, why the recommended prompt-object step shuts down 96 days later, and what to export before the endpoint stops answering.

9 min read
API Migration · OpenAI · Deprecation
News Aug 17 2026

Claude Code's Subagent Forking Default: What Changes for Your Multi-Agent Setup

Claude Code 2.1.232 makes a subagent_type "fork" subagent inherit the full parent conversation and prompt cache by default. Where the cost assumption moved, where context can leak between subagents, and what to check in an existing config.

12 min read
Agent Tooling · Subagents · Claude Code
Article Aug 16 2026

Prompt Cache Hit Rate: Why Your Cached Prompt Isn't Caching

The provider caches a prefix, and it fails without an error. Where the invalidator hides in prompt assembly, where breakpoints belong, and how to read the answer out of the usage fields.

17 min read
Operations · Prompt caching · Cost
News Aug 15 2026

Your Local Claude Code Sessions Are Now Retrievable by Your Organization

Three Compliance API endpoints, in beta for Claude Enterprise organizations, return transcripts of Cowork and Claude Code sessions run on users' own machines. What lands in the transcript, who can pull it, and what to change locally.

14 min read
Governance · Compliance API · Claude Code
News Aug 14 2026

Imagen 4 Shuts Down August 17: Migrate the Model ID Without Breaking Image Output

Three Imagen 4 endpoints are scheduled to shut down. Replace the request and response contract, then prove bytes, MIME type, dimensions, failures, and visual acceptance before cutover.

6 min read
Model Migration · Gemini API · Verification
Article Aug 13 2026

Caching AI Responses Without Serving the Wrong Answer: Keys, TTLs, and Tenant Isolation

Put every input the answer depended on into the cache key, replace TTL with a version component for derived answers, and prove isolation with a probe that exits non-zero on a leak.

18 min read
Operations · Caching · Multi-tenancy
Article Aug 12 2026

Agent Trace Observability: What to Log So a Failed AI Agent Run Is Debuggable

Emit one span per operation, propagate a single trace id, record the provider's request id, keep content capture opt-in, and prove it with a four-question drill.

12 min read
Operations · Tracing · Cost
Article Aug 11 2026

Secure MCP Server Authorization: Prevent Confused-Deputy Tool Calls

Bind tokens to the intended MCP resource, keep upstream credentials separate, require per-client consent, and prove the boundary with hostile credential tests.

11 min read
Security · MCP · OAuth
Article Aug 10 2026

Idempotent Tool Calls for AI Agents: Prevent Duplicate Side Effects

Design idempotent AI-agent tool calls that stay safe under timeouts, retries, and duplicate delivery, with a persistent operation record and failure tests.

12 min read
Reliability · Agents · Distributed Systems
Article Aug 9 2026

Zero Trust Architecture for Autonomous AI Agents

Allowing AI agents autonomous access to production data is a security risk without strict isolation. Learn how to design a zero trust architecture for your agentic workflows.

8 min read
Architecture · Security · Agents
Article Aug 8 2026

Setting Up Local AI Models for CI/CD Pipelines: Cost and Privacy Benefits

Relying on cloud APIs for AI support in CI/CD is expensive and leaks code. Learn how to run local models in your pipelines for testing and static analysis.

4 min read
Architecture · CI/CD · Privacy
Article Aug 7 2026

Modeling AI Infrastructure Costs: Tokens, Storage, and Observability

When developers budget for an AI feature, they usually count the tokens and stop there. Build a technical cost model that includes vector databases, tracing, and orchestration.

6 min read
Architecture · Infrastructure · Budget
Article Aug 6 2026

The AI Feature Flag Rollout Plan: Ship AI-Written Changes Behind a Toggle

Approval decides what an AI agent may change. A flag decides who actually sees it: percentage rollout, a fast kill path, and flag hygiene so flags never become permanent technical debt.

9 min read
Feature Flags · Rollout · Production Safety
Article Aug 5 2026

AI Agent Rollback Plans: Approval Gates That Keep Production Recoverable

A practical approval gate for production agents: define the action boundary, require reviewable evidence, bind the decision to a small scope, and plan recovery before execution.

9 min read
Agents · Approval · Rollback
Reliability Complete Aug 3 2026

Reliable AI API Calls: Timeouts, Retries, Rate Limits, and Fallbacks

Turn model calls into bounded production workflows with one deadline, classified failures, safe retries, concurrency limits, idempotent side effects, tested fallbacks, and end-to-end observability.

8 sections
Timeouts · Retries · Rate Limits · Fallbacks
Permissions Complete Aug 2 2026

Adding Teams and Permissions to Your Vibe Coded App

Turn a personal app into a shared workspace without leaking data between teams. Model memberships and roles, enforce every boundary where data is accessed, and prove it with two-workspace tests.

7 sections
Workspaces · Roles · Isolation Tests
Article Aug 2 2026

The AI Queue & Background Job Migration Plan: Moving Heavy Work Safely

A 5-step plan for migrating synchronous HTTP workloads to asynchronous queues and background workers with AI — covering payload isolation, idempotency keys, DLQs, polling, and backpressure.

10 min read
Architecture · Queues · Idempotency
Backups Complete Aug 1 2026

Adding Backups to Your Vibe Coded App

Rolling back a deploy restores your code, not your data. Back up the database and the uploaded files, keep one copy off the platform, and test a restore before you need it.

6 sections
Database · Uploads · Restore Drill
Article Jul 31 2026

The AI Performance Fix Plan: Measure Before You Let AI Optimize

A safer AI-assisted workflow for performance work: baseline on realistic data, locate the bottleneck with a profiler or explain plan, set a target and a price, change one thing, and re-measure identically.

16 min read
Performance · Profiling · Measurement
Memory Complete Jul 29 2026

Conversation Memory for AI Apps: State, Summarization, and Privacy

Build memory as governed application data: separate working context from durable facts, compact long threads, preserve provenance, isolate tenants, propagate deletion, and test both recall and forgetting.

8 sections
State · Summaries · Privacy · Testing
Security Complete Jul 28 2026

AI Guardrails for Developers: Prompt Injection, Tool Safety, and Output Validation

Build AI features that remain safe when prompts, retrieved documents, and model outputs are untrusted. Put permissions, tool validation, approvals, and output checks in code.

8 sections
Injection · Tools · Validation · Approval
News July 27 2026

Claude Opus 5 Keeps the Price and Changes the Bill

Opus 5 shipped July 24 at Opus 4.8's exact list price. Underneath it, thinking is on by default, the effort dial is the main cost control, and two prompt-cache rules moved in opposite directions.

7 min read
Model Release · Anthropic · Cost
Workflow Complete Jul 26 2026

Retrieval and RAG for Developers: Grounding AI Answers in Your Own Data

Most RAG failures are retrieval failures, not model failures. Diagnose where the pipeline breaks, chunk on document structure, choose an index, measure recall with a gold set, cite sources, and filter by permission.

6 sections
Chunking · Embeddings · Recall · Citations
Forms Complete Jul 25 2026

Adding Form Validation and Error Messages to Your Vibe Coded App

Add safe input validation to a vibe coded app. Client-side checks, server-side verification, clear error messages, and what to ask AI to build for you.

6 sections
Validation · Error Messages · User Experience
Email Complete Jul 24 2026

Adding Email and Notifications to Your Vibe Coded App

Send password resets, receipts, and alerts the safe way. Use a hosted email API, keep your keys server-side, authenticate your domain, and never email the wrong person.

6 sections
Deliverability · Keys · Recipients
Uploads Complete Jul 20 2026

Adding File Uploads to Your Vibe Coded App

Add photo and file uploads without writing files to your own server. Use hosted storage, validate what you actually received, and keep private files private.

6 sections
Storage · Access Control · Validation
Article Jul 19 2026

The AI File Storage Migration Plan: Move Uploads Without Breaking Links

A safer AI-assisted workflow for moving uploads: inventory the full storage contract, copy with evidence, preserve access rules, reconcile live changes, and retire the old path deliberately.

11 min read
File Storage · Uploads · Reliability
Accounts Complete Jul 18 2026

Adding User Accounts to Your Vibe Coded App

Add login without building your own password system. Use hosted auth, enforce per-user data access, and test the full account flow before real users sign up.

6 sections
Auth · Authorization · Data Access
Article Jul 17 2026

Migrate an Existing Background-Job Queue Without Losing Work

A safer AI-assisted workflow for queue changes: map stored work, prove producer-worker compatibility, preserve idempotency, drain deliberately, and retire the old path with evidence.

10 min read
Queues · Background Jobs · Reliability
Payments Complete Jul 15 2026

Adding Payments to Your Vibe Coded App

Payments are the one feature where an AI mistake costs real money. How to use hosted checkout safely, what to check in AI-generated payment code, and why webhooks matter more than the success page.

7 sections
Stripe · Checkout · Webhooks · Security
News July 15 2026

Microsoft's CLI Agent Rollout: 24% More Merged PRs, With a Catch

A new field study of Microsoft's early-2026 rollout of Claude Code and GitHub Copilot CLI found roughly 24% more merged PRs among adopters, while showing why teams need better rollout metrics than raw output.

5 min read
CLI Agents · Microsoft · Productivity
Workflow Complete Jul 15 2026

AI Observability: Logging, Tracing, and Monitoring AI Features in Production

Instrument AI features so you can explain what happened: structured logging without leaking secrets, OpenTelemetry tracing for agent pipelines, cost and drift metrics, and incident response dashboards.

6 sections
Logging · Tracing · Metrics · Incidents
Article Jul 15 2026

The AI Authentication Migration Plan: Change Login Without Locking Users Out

A safer AI-assisted workflow for auth changes: map the trust boundary, prove session and credential compatibility, stage rollout, and retire the old path with evidence.

10 min read
Security · Authentication · Migration
Article Jul 14 2026

The AI API Contract Change Plan: Evolve Endpoints Without Breaking Clients

A safer AI-assisted workflow for API changes: map consumers, prove old/new compatibility, stage an additive rollout, and retire the old contract with evidence.

9 min read
API · Compatibility · Reliability
Article Jul 13 2026

The AI Database Migration Plan: Change Schemas Without Guessing

A safer AI-assisted workflow for schema changes: map compatibility, stage expand-backfill-switch-contract, prove data invariants, and plan recovery.

8 min read
Database · Migration · Reliability
Article Jul 12 2026

The AI Dependency Upgrade Plan: Update Packages Without Guessing

A safer AI-assisted workflow for package upgrades: verify the version delta, map affected code, isolate the diff, define proof, and plan rollback.

7 min read
Dependencies · Maintenance · Testing
News July 11 2026

GPT-5.6 Goes GA: The Locked Preview Opens Two Weeks Later

OpenAI made GPT-5.6 Sol, Terra, and Luna generally available on July 9, 2026, after a 13-day limited preview. GA pricing, ultra mode with four parallel agents, and programmatic tool calling in the Responses API.

5 min read
Model Release · OpenAI · Agents
Article Jul 10 2026

The Intro-Pricing Trap: Budgeting AI Features on Promotional Prices

Promotional model pricing expires on a known date. Four guardrails: budget at list price, tag price-expiry dates, alert on unit cost, and pre-plan the downgrade.

6 min read
Cost · Budget · Planning
Article Jul 9 2026

AI Merge Readiness Checklist: 10 Questions Before You Approve

A practical pre-merge checklist for AI-assisted pull requests: 10 questions covering scope, tests, risk, rollout, and rollback before approval.

3 min read
Review · Risk · Workflow
Article Jul 5 2026

25 AI Code Review Comments That Actually Improve Diffs

25 copy-ready code review comments for AI-assisted diffs, grouped by correctness, security, tests, scope, and rollback — precise, not vague.

6 min read
Review · Templates · Reference
Article Jul 4 2026

AI Regression Test Plan Template

A copy-paste template for scoping regression tests around an AI-assisted change: what could break, which suites to run, and what to check by hand.

4 min read
Testing · Scope · Templates
Article Jul 4 2026

The AI Verification Ladder: Confidence Levels Before Merge

A practical way to match AI change risk to the right depth of validation, using five confidence levels before merge.

4 min read
Workflow · Testing · Review
Article Jul 3 2026

Model Fallback Runbook Template: The First 30 Minutes

A minute-by-minute runbook for the first 30 minutes of an AI provider outage: who acts, what to check, and when to declare the incident stable.

5 min read
Reliability · Incidents · Fallback
Article Jul 2 2026

AI PR Review Checklist Template for Engineering Teams

A copy-paste PR template that standardizes how your whole team reviews AI-assisted pull requests, so review quality doesn't depend on who's on call.

5 min read
Workflow · Team · Templates
Article Jul 2 2026

The AI Decision Log: Stop Re-Debating the Same Change

A practical way to keep AI coding work consistent across sessions: log key decisions, rationale, constraints, and checks so the next prompt starts from truth instead of guesswork.

5 min read
Workflow · Decision Log · Consistency
Article Jul 1 2026

AI Change Risk Matrix: Scope, Tests, Rollback Before Merge

A practical matrix for deciding how risky an AI-generated change is before merge, with scope, test depth, review evidence, and rollback requirements.

4 min read
Risk · Review · Rollback
Article Jul 1 2026

Run a Model Fallback Drill Before You Need One

A practical workflow for testing AI model fallback before an outage: trigger conditions, quality gates, rollback rules, and the one-page drill your team should run each month.

6 min read
Reliability · Fallback · Production
Article Jun 30 2026

15 Acceptance Criteria Examples for AI Coding Tasks

Copy-ready acceptance criteria examples for AI coding tasks: UI, API, data, auth, tests, refactors, migrations, and rollback.

9 min read
Criteria · Examples · Review
Article Jun 30 2026

Writing the Context File: AGENTS.md and CLAUDE.md Done Right

What belongs in an AI agent's context file and what doesn't: commands, architecture, conventions, and boundaries — plus how to keep it short, true, and maintained like code.

7 min read
Workflow · Context · Agents
Article Jun 29 2026

The AI Acceptance Criteria Prompt: Define Done Before the Diff

A practical way to define acceptance criteria before AI writes code, so reviews are based on clear pass/fail outcomes instead of opinions.

4 min read
Workflow · Review · Scope
News June 29 2026

GPT-5.6 Sol Launches in a Locked Preview: The Best Coding Model You Can't Use Yet

OpenAI previewed GPT-5.6 Sol on June 26, 2026 — a new state of the art on Terminal-Bench 2.1, with an ultra mode that runs subagents. But access is limited to a small set of partners after the U.S. government reviewed the launch.

5 min read
Model Release · OpenAI · Agents
Article Jun 28 2026

Running AI Agents in Parallel

A practical method for running two or three coding agents at once without losing control: task isolation, branch hygiene, one reviewer, and when parallel actually slows you down.

7 min read
Workflow · Multi-Agent · Review
News June 26 2026

Windsurf Is Now Devin Desktop: What Changes Before Cascade's July Cutoff

Cognition retired the Windsurf brand on June 2, 2026, relaunching it as Devin Desktop with an Agent Command Center and ACP support. Cascade, Windsurf's local agent, remains available through July 2026.

4 min read
Tools · Editors · Agents
Article Jun 25 2026

The AI Session Resume Packet

A practical way to make AI coding sessions resumable: capture goal, current state, decisions, changed files, open risks, validation, and the next prompt.

7 min read
Workflow · Handoff · Validation
Article Jun 24 2026

The AI Bug Report That Actually Helps

A practical structure for AI bug reports: observed behavior, expected behavior, reproduction path, relevant context, evidence, and fix boundaries.

6 min read
Debugging · Prompts · Validation
Costs Complete Jun 23 2026

Why Your AI Bill Got Expensive

Free tiers run out, credits disappear faster than expected, and some tools now meter usage by the token. Why AI costs spike for vibe coders, and how to keep control of what you spend.

7 sections
Billing Models · Free Tiers · Spending Limits
News June 22 2026

Claude Fable 5's Free Window Ends While Access Is Still Suspended

Fable 5's no-extra-cost subscription window ended June 22. As of June 28, Anthropic's access statement still says Fable 5 and Mythos 5 were removed from all users while access is restored.

4 min read
Pricing · Model Release · Claude
Article Jun 18 2026

When Your AI Model Gets Pulled: Building for Model Availability Risk

A practical framework for AI model availability risk: why models get pulled, deprecated, or restricted, and how to build features that survive losing one.

7 min read
Reliability · Vendor Risk · Production
Article Jun 17 2026

The AI Plan Before Code: Stop Letting AI Start in the Middle

A practical workflow for asking AI to plan before it edits: define intent, constraints, risks, validation, and rollback before accepting code changes.

7 min read
Planning · Review · Validation
News June 14 2026

OpenCode Crosses 160,000 Stars: Inside the Model-Agnostic CLI Agent

The open-source terminal agent OpenCode crossed 160K+ GitHub stars and 7.5M monthly active developers, with support for 75+ model providers and a fast release cadence (v1.16.0 in early June, v1.17.x soon after) — what its provider-agnostic, BYOK approach means for your CLI workflow.

5 min read
Tools · CLI · Open Source
Article Jun 13 2026

The AI Change Budget: How Much Should You Let AI Edit at Once?

A practical framework for deciding how large an AI-generated change can be before reviewability, tests, rollback, and production risk say to split it.

8 min read
Workflow · Review · Scope
Article Jun 7 2026

Why Small Diffs Win With AI

Broad rewrite prompts feel fast, but small diffs plus tight validation loops usually produce better AI-assisted code with less cleanup.

6 min read
Workflow · Iteration · Quality
Article Jun 6 2026

The AI Code Ownership Checklist: Before You Merge

A practical merge checklist for AI-generated code: behavior, tests, contracts, edge cases, security, and observability.

6 min read
Quality · Review · Production
News June 4 2026

Claude Opus 4.8 Reaches 88.6% on SWE-bench Verified

Anthropic's latest Opus release reports an 88.6% SWE-bench Verified score, with stronger agentic coding behavior, dynamic workflows, and better uncertainty signaling.

4 min read
Model Release · Benchmarks · Agents
Article Jun 3 2026

The True Cost of Context: Why Context Dumping is an Anti-Pattern

Large context windows make it easy to include everything, but more context is not always better. Why targeted context curation improves quality, speed, and cost when coding with AI.

6 min read
Prompting · Context · Quality
Handoff Complete Jun 2 2026

How to Hand Off a Vibe-Coded App to a Developer

You built a working app with AI. Now a developer needs to stabilize it, review it, or take it further. Here's what to prepare so the handoff is clear instead of chaotic.

9 sections
Brief · Risks · Stabilization · Checklist
News June 1 2026

Codex in Production: Self-Improving Agents and Eval Loops

OpenAI's latest engineering case study shows a concrete production pattern: expert feedback becomes traces, traces become eval targets, and Codex helps ship bounded improvements with human review.

5 min read
Engineering · Agents · Loops
Workflow Complete May 30 2026

Multi-Agent Systems and Tool Use for Developers

Build reliable agent pipelines: tool use patterns, orchestrator–subagent coordination, parallel execution with concurrency limits, loop termination guards, tool input validation, and error recovery.

8 sections
Tool Use · Orchestration · Parallel · Error Recovery
Workflow Complete May 29 2026

Streaming AI Responses: SSE, Real-Time UI, and Production Patterns

Stream AI responses end-to-end: Anthropic SDK streaming, passing SSE through a Node.js/Express backend, consuming streams in React, abort handling, WebSockets vs SSE, and streaming with tool use.

8 sections
SSE · React · Abort · Tool Use
Code Reading Complete May 29 2026

How to Read AI-Generated Code When You Don't Fully Understand It

Your app works but do you understand what AI built? How to map the project, trace user flows, spot risky shortcuts, and know when to ask a developer for help.

12 sections
Structure · Flow · Risks · Git
News May 29 2026

Claude Opus 4.8: 1M Context, Adaptive Thinking, Dreaming Agents

What actually changed in Claude Opus 4.8 for developers. 1M token context is now default. Adaptive thinking cuts wasted reasoning tokens. Dreaming gives agents persistent memory between sessions.

4 min read
Model Release · API · Agents
Workflow Complete May 28 2026

Local and Private AI Models for Developers

When code genuinely can't leave your machine: Ollama, LM Studio, Jan, and which models are worth running. Covers NDA and air-gapped use cases, VS Code integration via Continue, and private cloud as a middle option.

7 sections
Ollama · Local Models · Air-Gapped · NDA
Workflow Complete May 27 2026

AI Cost Modeling: Tokens, Model Selection, and Budget Control

Token costs are predictable if you model them before you ship. Covers Haiku vs Sonnet vs Opus selection, prompt caching, max_tokens control, pre-ship cost estimation, usage logging, and spending alerts.

6 sections
Model Tiers · Caching · Budgets · Rate Limits
Workflow Complete May 26 2026

Sanitizing Code and Data Before Sending to AI

What to scrub before using cloud AI: credentials, PII, business logic, customer data, and logs. Includes automated scanning with TruffleHog and Gitleaks, a sed log-scrubbing script, and guidance on when to switch to a local model.

7 sections
Credentials · PII · Logs · Local Models
Case Study May 26 2026

Case Study: Refactoring Legacy Authentication with AI

A concrete example of using AI to modernize an undocumented legacy authentication controller. From the initial messy state to a clean, tested, and validated result.

2 min read
Diff · Testing · Results
News May 26 2026

The Multi-Agent Coding Stack: Cursor, Claude Code, Codex

The era of one AI coding tool is over. Many senior developers now run 2–3 tools in parallel. Cursor 3.2 ships /multitask for parallel subagents. Zed 1.0 adds the Agent Client Protocol.

5 min read
Tools · Workflow · Agents
News May 21 2026

Google I/O 2026: The Developer Edition

Everything from Google I/O that actually matters for developers: Gemini 3.5 Flash, Antigravity 2.0 subagents, the Managed Agents API, WebMCP, and Android CLI 1.0 — stripped of the keynote hype.

5 min read
Platform · Models · APIs
Workflow Complete Apr 25 2026

AI Code Review: From Diff to Production Confidence

Use AI to review your own code before opening a PR, catch regression risks, spot security issues, generate test ideas, and write better review comments. A structured workflow for every stage of review.

6 sections
7 prompt templates
Self-review · Regression · Security · Tests
Debugging Complete Apr 25 2026

How to Fix a Broken Vibe Coded App

Your app almost works but something is wrong and AI keeps making it worse. A concrete guide to diagnosing and fixing bugs, broken state, auth issues, and deploy problems.

6 sections
Bugs · State · Auth · Deploy
Article Apr 25 2026

Why AI Code Feels Fast But Fragile

AI-generated code can make the first hour feel magical, then become brittle when edge cases, tests, integration, and maintenance arrive. Here's how to keep the speed without losing the structure.

11 min read
Quality · Testing · Maintainability
Workflow Complete Apr 22 2026

AI Evals in Production

Keep AI quality stable in real systems. Build eval datasets, run prompt regression in CI, add release quality gates, and monitor drift after deploy.

6 sections
12 eval patterns
CI · Quality Gates · Observability
Tool Guide Complete Apr 22 2026

Which Vibe Coding Tool Should You Use?

Claude, Bolt, Lovable, Replit, or v0 — they all let you build with AI, but they're designed for different things. A practical breakdown of each tool, what it's best for, and how to choose the right one for your project.

5 tools compared
Decision framework
No coding experience needed
Article Apr 22 2026

Should This Feature Use AI?

A practical decision framework for when AI belongs in a product feature, when ordinary code is better, and how to keep probabilistic systems away from decisions that need deterministic control.

13 min read
Decision Framework · Product · Production
Workflow Complete Apr 16 2026

Building AI-Powered Products with Claude API

For developers building products on top of Claude. System prompt design, context management, prompt caching, cost optimization, streaming, and tool use — with real working code for every pattern.

8 sections
20+ code examples
System Prompts · Caching · Streaming · Tools
Workflow Complete Apr 16 2026

Debugging with AI

The investigation workflow for debugging with AI — reading error messages, interpreting stack traces, bisecting problems, and knowing when to give AI more context vs. start fresh. Plus a copy-paste prompt library for every bug category.

7 sections
7 prompt templates
Errors · Async · Performance · Env
Reference Complete Apr 16 2026

Prompt Engineering for Python

Concrete AI prompts for Python development. Pydantic-first prompting, FastAPI endpoints, SQLAlchemy async patterns, pytest, and Django — with a copy-paste prompt library for every common scenario.

7 sections
8 prompt templates
Pydantic · FastAPI · SQLAlchemy · pytest
Growth Complete Apr 16 2026

Growing Your Vibe Coded App

Your app is live and people are using it. How do you add features without breaking things, store real user data, respond to feedback, and handle it when something breaks on live?

6 sections
Features · Data · Feedback · Maintenance
Workflow Complete Apr 14 2026

AI-Assisted CI/CD

Use AI to write GitHub Actions workflows, generate production Dockerfiles, automate code review in CI, and build deployment pipelines — with real working examples for every stage.

6 sections
8 workflow examples
Actions · Docker · Deploy · Debug
Workflow Complete Apr 14 2026

Working with AI in a Team

You're a developer on a team that uses AI. This guide covers how to participate — contributing to shared context files, self-reviewing before PRs, using the team prompt library, and onboarding into an AI-augmented codebase.

5 sections
4 prompt templates
Context · PRs · Prompts · Onboarding
Article Complete Apr 12 2026

When Vibe Coding Isn't Enough

An honest guide to recognizing when your project has outgrown AI-only building — and how to find and talk to a developer when you don't know code.

17 min read
Limits · Hiring · Communication
Leadership Complete Apr 10 2026

AI for Technical Leads & Architects

You lead a team that uses AI. This guide covers the decisions above the keyboard — defining the shared context file, setting the PR review process, building the organizational prompt library, and using AI for architecture decisions.

6 sections
3 prompt templates
Review · Workflows · Architecture
Deployment Complete Apr 9 2026

Deploying Your Vibe Coded App

Your app works in the preview. Now put it on the internet. Step-by-step deployment for HTML files, Bolt, Replit, Lovable, and v0 — plus custom domains, data storage, and what surprises people after going live.

5 platforms covered
No coding required
Free · Domains · Data
Workflow Complete Apr 7 2026

AI-Assisted Database Design

Design schemas, write safe migrations, optimize slow queries, and evolve a live database — with AI as your design partner. From first ERD to production, with real prompts at every step.

6 sections
3 databases
Schema · Migrations · Queries
Workflow Complete Apr 6 2026

Testing with AI

Write better tests faster. Unit tests, integration tests, TDD workflows, mocking patterns, and edge case generation — with real prompts for every scenario and framework.

6 sections
3 test types
Unit · Integration · TDD
Reference Complete Mar 23 2026

AI Prompt Library

50+ ready-to-use prompts for debugging, code review, testing, refactoring, documentation, security auditing, and more. Searchable, filterable, copy-paste ready.

53 prompts
10 categories
Search · Filter · Copy
Case Study Mar 21 2026

How This Site Was Built: A Developer and AI, Start to Finish

The full story of building aiprogrammingmanual.com — one developer and Claude, over 6 weeks. What worked, what went wrong, and what I'd do differently.

13 min read
Case Study · Behind the Scenes
Walkthrough Complete Mar 20 2026

A Day of Vibe Coding: Building a Real App

Follow along as we build a movie watchlist app in one afternoon. Every prompt, every revision, every bug — from first idea at 1 PM to working app at 4 PM.

3 hour build
Step by step
Prompts · Fixes · Testing
Article Mar 20 2026

How AI APIs Work (And Why You're Already Using Them)

Every time you use Claude or ChatGPT, an API is doing the work behind the scenes. What's actually happening, how tokens and pricing work, and why this one concept explains the entire AI tool landscape.

7 min read
Concepts · Practical · Accessible
Article Mar 17 2026

Where Vibe Coding Is Actually Going

Vibe coding is moving toward agent supervision and multi-tool workflows, but product judgment, review, security, and maintenance still decide what survives.

12 min read
Perspective · Analysis · Honest
Pitfalls Complete Mar 16 2026

7 Vibe Coding Mistakes That Waste Your Time

The traps that turn a fun afternoon into hours of frustration. Real scenarios, practical fixes — from describing too much at once to going in circles instead of starting fresh.

7 mistakes
Concrete examples
Before & After prompts
Learning Path Complete Mar 15 2026

How to Start Building With AI

A step-by-step learning path from your first AI conversation to building real apps. No programming experience needed — just curiosity and something you want to build.

7 steps
Beginner-friendly
Tools · Projects · Debugging
Article Mar 15 2026

How AI Models Are Trained: What's Actually Happening

The training process behind Claude, ChatGPT, and other AI tools — explained in plain language. Why AI hallucinates, why it writes outdated code, and why context improves results so dramatically.

12 min read
Concepts · Behind the Scenes
Start Here Complete Mar 14 2026

Vibe Coding: The Practical Guide

How to build real software by describing what you want to AI. Tools, techniques, common traps, and how to tell when something is actually working vs just looking like it works.

7 sections
Tools · Workflow · Pitfalls
No coding experience needed
Article Mar 14 2026

How AI Programming Is Different From Traditional Development

Deterministic code vs probabilistic systems, writing rules vs providing data, and why debugging AI feels completely different. What changes when you move from traditional software to AI-assisted development.

9 min read
Concepts · Comparison · Practical
Tutorial Complete Mar 13 2026

Build a REST API from Spec to Deployment

Design, build, test, and deploy a complete bookmark manager API. From OpenAPI spec through Express, TypeScript, integration tests, Docker, and production deployment.

6 parts
10 endpoints
Express · SQLite · Zod · Docker
Reference Complete Mar 11 2026

Prompt Engineering for TypeScript/React

Concrete prompts for TypeScript and React development. Type-first prompting, component patterns, state management, API routes, and a copy-paste prompt library.

6 sections
8 prompt templates
Types · Components · API · Library
Workflow Complete Mar 10 2026

AI-Assisted Dev with VS Code & Cursor

Practical setup and workflow guide for AI-assisted editors. Configuration, keyboard shortcuts, project rules files, and the editing habits that actually make you faster.

6 sections
2 editors
Config · Habits · Workflows
Workflow Complete Mar 9 2026

Migrating a Legacy Codebase with AI

A five-phase approach to understanding, testing, and modernizing legacy code with AI. From comprehension through validation — one module at a time, never breaking what works.

5 phases
4 pattern transforms
Strategy · Prompts · Checklists
Workflow Complete Feb 24 2026

CLI-First AI Development

AI-assisted development from the terminal. Claude Code, Aider, shell patterns, tmux workflows, and automation scripts for developers who live in the command line.

6 sections
2 CLI tools
Shell · tmux · Automation
Mindset Complete Feb 22 2026

The Senior Developer's Guide to Not Fighting AI

You've spent years building real expertise. AI feels like it cheapens all of that. This guide addresses eight specific resistances honestly — and shows a pragmatic path forward.

8 resistances
4 week adoption
Mindset · Practical · Honest
Field Guide Complete Feb 20 2026

When AI Gets It Wrong: A Field Guide

An honest catalog of nine ways AI-generated code fails — with real examples, real fixes, and a practical checklist for catching every category of error before it ships.

9 failure modes
4 detection techniques
Examples · Fixes · Checklist
Tutorial Complete Feb 9 2026

Build a Full-Stack App with AI in a Weekend

Put the methodology into practice in this illustrated tutorial. Follow the process of building Taskflow — a complete task management app — in one weekend, AI-first. Features example prompts, architectural decisions, and AI responses.

5 parts
10 milestones
React · TypeScript · Express · SQLite
Reference Complete Feb 4 2026

AI Developer Tools: A Practical Guide

The complete landscape of AI development tools — chat interfaces, editor integrations, CLI tools, and APIs. What to use, when to use it, and how to set up your stack.

6 sections
4 tool categories
Setup · Comparison · Recommendations
Manual Start Here Feb 1 2026

The Complete Guide to AI-Assisted Development

The comprehensive guide. From your first AI prompt to an invisible framework of expert-level habits — 20 chapters covering prompting, pair programming, system design, testing, security, cognitive workflows, and meta-methodology.

20 chapters
4 skill tiers
Foundations → Mastery
Reliability Complete Aug 3 2026

Reliable AI API Calls: Timeouts, Retries, Rate Limits, and Fallbacks

Turn model calls into bounded production workflows with one deadline, classified failures, safe retries, concurrency limits, idempotent side effects, tested fallbacks, and end-to-end observability.

8 sections
Timeouts · Retries · Rate Limits · Fallbacks
Memory Complete Jul 29 2026

Conversation Memory for AI Apps: State, Summarization, and Privacy

Build memory as governed application data: separate working context from durable facts, compact long threads, preserve provenance, isolate tenants, propagate deletion, and test both recall and forgetting.

8 sections
State · Summaries · Privacy · Testing
Security Complete Jul 28 2026

AI Guardrails for Developers: Prompt Injection, Tool Safety, and Output Validation

Build AI features that remain safe when prompts, retrieved documents, and model outputs are untrusted. Put permissions, tool validation, approvals, and output checks in code.

8 sections
Injection · Tools · Validation · Approval
Workflow Complete Jul 26 2026

Retrieval and RAG for Developers: Grounding AI Answers in Your Own Data

Most RAG failures are retrieval failures, not model failures. Diagnose where the pipeline breaks, chunk on document structure, choose an index, measure recall with a gold set, cite sources, and filter by permission.

6 sections
Chunking · Embeddings · Recall · Citations
Workflow Complete Jul 15 2026

AI Observability: Logging, Tracing, and Monitoring AI Features in Production

Instrument AI features so you can explain what happened: structured logging without leaking secrets, OpenTelemetry tracing for agent pipelines, cost and drift metrics, and incident response dashboards.

6 sections
Logging · Tracing · Metrics · Incidents
Workflow Complete May 30 2026

Multi-Agent Systems and Tool Use for Developers

Build reliable agent pipelines: tool use patterns, orchestrator–subagent coordination, parallel execution with concurrency limits, loop termination guards, tool input validation, and error recovery.

8 sections
Tool Use · Orchestration · Parallel · Error Recovery
Workflow Complete May 29 2026

Streaming AI Responses: SSE, Real-Time UI, and Production Patterns

Stream AI responses end-to-end: Anthropic SDK streaming, passing SSE through a Node.js/Express backend, consuming streams in React, abort handling, WebSockets vs SSE, and streaming with tool use.

8 sections
SSE · React · Abort · Tool Use
Workflow Complete May 28 2026

Local and Private AI Models for Developers

When code genuinely can't leave your machine: Ollama, LM Studio, Jan, and which models are worth running. Covers NDA and air-gapped use cases, VS Code integration via Continue, and private cloud as a middle option.

7 sections
Ollama · Local Models · Air-Gapped · NDA
Workflow Complete May 27 2026

AI Cost Modeling: Tokens, Model Selection, and Budget Control

Token costs are predictable if you model them before you ship. Covers Haiku vs Sonnet vs Opus selection, prompt caching, max_tokens control, pre-ship cost estimation, usage logging, and spending alerts.

6 sections
Model Tiers · Caching · Budgets · Rate Limits
Workflow Complete May 26 2026

Sanitizing Code and Data Before Sending to AI

What to scrub before using cloud AI: credentials, PII, business logic, customer data, and logs. Includes automated scanning with TruffleHog and Gitleaks, a sed log-scrubbing script, and guidance on when to switch to a local model.

7 sections
Credentials · PII · Logs · Local Models
Workflow Complete Apr 25 2026

AI Code Review: From Diff to Production Confidence

Use AI to review your own code before opening a PR, catch regression risks, spot security issues, generate test ideas, and write better review comments. A structured workflow for every stage of review.

6 sections
7 prompt templates
Self-review · Regression · Security · Tests
Workflow Complete Apr 22 2026

AI Evals in Production

Keep AI quality stable in real systems. Build eval datasets, run prompt regression in CI, add release quality gates, and monitor drift after deploy.

6 sections
12 eval patterns
CI · Quality Gates · Observability
Workflow Complete Apr 16 2026

Building AI-Powered Products with Claude API

For developers building products on top of Claude. System prompt design, context management, prompt caching, cost optimization, streaming, and tool use — with real working code for every pattern.

8 sections
20+ code examples
System Prompts · Caching · Streaming · Tools
Workflow Complete Apr 16 2026

Debugging with AI

The investigation workflow for debugging with AI — reading error messages, interpreting stack traces, bisecting problems, and knowing when to give AI more context vs. start fresh. Plus a copy-paste prompt library for every bug category.

7 sections
7 prompt templates
Errors · Async · Performance · Env
Reference Complete Apr 16 2026

Prompt Engineering for Python

Concrete AI prompts for Python development. Pydantic-first prompting, FastAPI endpoints, SQLAlchemy async patterns, pytest, and Django — with a copy-paste prompt library for every common scenario.

7 sections
8 prompt templates
Pydantic · FastAPI · SQLAlchemy · pytest
Workflow Complete Apr 14 2026

AI-Assisted CI/CD

Use AI to write GitHub Actions workflows, generate production Dockerfiles, automate code review in CI, and build deployment pipelines — with real working examples for every stage.

6 sections
8 workflow examples
Actions · Docker · Deploy · Debug
Workflow Complete Apr 14 2026

Working with AI in a Team

You're a developer on a team that uses AI. This guide covers how to participate — contributing to shared context files, self-reviewing before PRs, using the team prompt library, and onboarding into an AI-augmented codebase.

5 sections
4 prompt templates
Context · PRs · Prompts · Onboarding
Leadership Complete Apr 10 2026

AI for Technical Leads & Architects

You lead a team that uses AI. This guide covers the decisions above the keyboard — defining the shared context file, setting the PR review process, building the organizational prompt library, and using AI for architecture decisions.

6 sections
3 prompt templates
Review · Workflows · Architecture
Workflow Complete Apr 7 2026

AI-Assisted Database Design

Design schemas, write safe migrations, optimize slow queries, and evolve a live database — with AI as your design partner. From first ERD to production, with real prompts at every step.

6 sections
3 databases
Schema · Migrations · Queries
Workflow Complete Apr 6 2026

Testing with AI

Write better tests faster. Unit tests, integration tests, TDD workflows, mocking patterns, and edge case generation — with real prompts for every scenario and framework.

6 sections
3 test types
Unit · Integration · TDD
Reference Complete Mar 23 2026

AI Prompt Library

50+ ready-to-use prompts for debugging, code review, testing, refactoring, documentation, security auditing, and more. Searchable, filterable, copy-paste ready.

53 prompts
10 categories
Search · Filter · Copy
Tutorial Complete Mar 13 2026

Build a REST API from Spec to Deployment

Design, build, test, and deploy a complete bookmark manager API. From OpenAPI spec through Express, TypeScript, integration tests, Docker, and production deployment.

6 parts
10 endpoints
Express · SQLite · Zod · Docker
Reference Complete Mar 11 2026

Prompt Engineering for TypeScript/React

Concrete prompts for TypeScript and React development. Type-first prompting, component patterns, state management, API routes, and a copy-paste prompt library.

6 sections
8 prompt templates
Types · Components · API · Library
Workflow Complete Mar 10 2026

AI-Assisted Dev with VS Code & Cursor

Practical setup and workflow guide for AI-assisted editors. Configuration, keyboard shortcuts, project rules files, and the editing habits that actually make you faster.

6 sections
2 editors
Config · Habits · Workflows
Workflow Complete Mar 9 2026

Migrating a Legacy Codebase with AI

A five-phase approach to understanding, testing, and modernizing legacy code with AI. From comprehension through validation — one module at a time, never breaking what works.

5 phases
4 pattern transforms
Strategy · Prompts · Checklists
Workflow Complete Feb 24 2026

CLI-First AI Development

AI-assisted development from the terminal. Claude Code, Aider, shell patterns, tmux workflows, and automation scripts for developers who live in the command line.

6 sections
2 CLI tools
Shell · tmux · Automation
Mindset Complete Feb 22 2026

The Senior Developer's Guide to Not Fighting AI

You've spent years building real expertise. AI feels like it cheapens all of that. This guide addresses eight specific resistances honestly — and shows a pragmatic path forward.

8 resistances
4 week adoption
Mindset · Practical · Honest
Field Guide Complete Feb 20 2026

When AI Gets It Wrong: A Field Guide

An honest catalog of nine ways AI-generated code fails — with real examples, real fixes, and a practical checklist for catching every category of error before it ships.

9 failure modes
4 detection techniques
Examples · Fixes · Checklist
Tutorial Complete Feb 9 2026

Build a Full-Stack App with AI in a Weekend

Put the methodology into practice in this illustrated tutorial. Follow the process of building Taskflow — a complete task management app — in one weekend, AI-first. Features example prompts, architectural decisions, and AI responses.

5 parts
10 milestones
React · TypeScript · Express · SQLite
Reference Complete Feb 4 2026

AI Developer Tools: A Practical Guide

The complete landscape of AI development tools — chat interfaces, editor integrations, CLI tools, and APIs. What to use, when to use it, and how to set up your stack.

6 sections
4 tool categories
Setup · Comparison · Recommendations
Manual Start Here Feb 1 2026

The Complete Guide to AI-Assisted Development

The comprehensive guide. From your first AI prompt to an invisible framework of expert-level habits — 20 chapters covering prompting, pair programming, system design, testing, security, cognitive workflows, and meta-methodology.

20 chapters
4 skill tiers
Foundations → Mastery

You build by describing what you want, not by writing code line by line. These guides help you do it better — and know when you've hit the limits.

Permissions Complete Aug 2 2026

Adding Teams and Permissions to Your Vibe Coded App

Turn a personal app into a shared workspace without leaking data between teams. Model memberships and roles, enforce every boundary where data is accessed, and prove it with two-workspace tests.

7 sections
Workspaces · Roles · Isolation Tests
Backups Complete Aug 1 2026

Adding Backups to Your Vibe Coded App

Rolling back a deploy restores your code, not your data. Back up the database and the uploaded files, keep one copy off the platform, and test a restore before you need it.

6 sections
Database · Uploads · Restore Drill
Forms Complete Jul 25 2026

Adding Form Validation and Error Messages to Your Vibe Coded App

Add safe input validation to a vibe coded app. Client-side checks, server-side verification, clear error messages, and what to ask AI to build for you.

6 sections
Validation · Error Messages · User Experience
Email Complete Jul 24 2026

Adding Email and Notifications to Your Vibe Coded App

Send password resets, receipts, and alerts the safe way. Use a hosted email API, keep your keys server-side, authenticate your domain, and never email the wrong person.

6 sections
Deliverability · Keys · Recipients
Uploads Complete Jul 20 2026

Adding File Uploads to Your Vibe Coded App

Add photo and file uploads without writing files to your own server. Use hosted storage, validate what you actually received, and keep private files private.

6 sections
Storage · Access Control · Validation
Accounts Complete Jul 18 2026

Adding User Accounts to Your Vibe Coded App

Add login without building your own password system. Use hosted auth, enforce per-user data access, and test the full account flow before real users sign up.

6 sections
Auth · Authorization · Data Access
Payments Complete Jul 15 2026

Adding Payments to Your Vibe Coded App

Payments are the one feature where an AI mistake costs real money. How to use hosted checkout safely, what to check in AI-generated payment code, and why webhooks matter more than the success page.

7 sections
Stripe · Checkout · Webhooks · Security
Costs Complete Jun 23 2026

Why Your AI Bill Got Expensive

Free tiers run out, credits disappear faster than expected, and some tools now meter usage by the token. Why AI costs spike for vibe coders, and how to keep control of what you spend.

7 sections
Billing Models · Free Tiers · Spending Limits
Handoff Complete Jun 2 2026

How to Hand Off a Vibe-Coded App to a Developer

You built a working app with AI. Now a developer needs to stabilize it, review it, or take it further. Here's what to prepare so the handoff is clear instead of chaotic.

9 sections
Brief · Risks · Stabilization · Checklist
Code Reading Complete May 29 2026

How to Read AI-Generated Code When You Don't Fully Understand It

Your app works but do you understand what AI built? How to map the project, trace user flows, spot risky shortcuts, and know when to ask a developer for help.

12 sections
Structure · Flow · Risks · Git
Debugging Complete Apr 25 2026

How to Fix a Broken Vibe Coded App

Your app almost works but something is wrong and AI keeps making it worse. A concrete guide to diagnosing and fixing bugs, broken state, auth issues, and deploy problems.

6 sections
Bugs · State · Auth · Deploy
Tool Guide Complete Apr 22 2026

Which Vibe Coding Tool Should You Use?

Claude, Bolt, Lovable, Replit, or v0 — they all let you build with AI, but they're designed for different things. A practical breakdown of each tool, what it's best for, and how to choose the right one for your project.

5 tools compared
Decision framework
No coding experience needed
Growth Complete Apr 16 2026

Growing Your Vibe Coded App

Your app is live and people are using it. How do you add features without breaking things, store real user data, respond to feedback, and handle it when something breaks on live?

6 sections
Features · Data · Feedback · Maintenance
Article Complete Apr 12 2026

When Vibe Coding Isn't Enough

An honest guide to recognizing when your project has outgrown AI-only building — and how to find and talk to a developer when you don't know code.

17 min read
Limits · Hiring · Communication
Deployment Complete Apr 9 2026

Deploying Your Vibe Coded App

Your app works in the preview. Now put it on the internet. Step-by-step deployment for HTML files, Bolt, Replit, Lovable, and v0 — plus custom domains, data storage, and what surprises people after going live.

5 platforms covered
No coding required
Free · Domains · Data
Walkthrough Complete Mar 20 2026

A Day of Vibe Coding: Building a Real App

Follow along as we build a movie watchlist app in one afternoon. Every prompt, every revision, every bug — from first idea at 1 PM to working app at 4 PM.

3 hour build
Step by step
Prompts · Fixes · Testing
Pitfalls Complete Mar 16 2026

7 Vibe Coding Mistakes That Waste Your Time

The traps that turn a fun afternoon into hours of frustration. Real scenarios, practical fixes — from describing too much at once to going in circles instead of starting fresh.

7 mistakes
Concrete examples
Before & After prompts
Learning Path Complete Mar 15 2026

How to Start Building With AI

A step-by-step learning path from your first AI conversation to building real apps. No programming experience needed — just curiosity and something you want to build.

7 steps
Beginner-friendly
Tools · Projects · Debugging
Start Here Complete Mar 14 2026

Vibe Coding: The Practical Guide

How to build real software by describing what you want to AI. Tools, techniques, common traps, and how to tell when something is actually working vs just looking like it works.

7 sections
Tools · Workflow · Pitfalls
No coding experience needed

Shorter reads on specific topics — ideas, perspectives, and practical takes on AI-assisted development.

Article Aug 19 2026

Resume an Agent Run After a Crash: Checkpoints, Durable State, and Safe Replay

A dead run should restart at the step it reached, not at step one. The checkpoint record, the three replay classes, commit order around external effects, and the kill test that proves it works.

20 min read
Reliability · Agents · Durable state
Article Aug 16 2026

Prompt Cache Hit Rate: Why Your Cached Prompt Isn't Caching

The provider caches a prefix, and it fails without an error. Where the invalidator hides in prompt assembly, where breakpoints belong, and how to read the answer out of the usage fields.

17 min read
Operations · Prompt caching · Cost
Article Aug 13 2026

Caching AI Responses Without Serving the Wrong Answer: Keys, TTLs, and Tenant Isolation

Put every input the answer depended on into the cache key, replace TTL with a version component for derived answers, and prove isolation with a probe that exits non-zero on a leak.

18 min read
Operations · Caching · Multi-tenancy
Article Aug 12 2026

Agent Trace Observability: What to Log So a Failed AI Agent Run Is Debuggable

Emit one span per operation, propagate a single trace id, record the provider's request id, keep content capture opt-in, and prove it with a four-question drill.

12 min read
Operations · Tracing · Cost
Article Aug 11 2026

Secure MCP Server Authorization: Prevent Confused-Deputy Tool Calls

Bind tokens to the intended MCP resource, keep upstream credentials separate, require per-client consent, and prove the boundary with hostile credential tests.

11 min read
Security · MCP · OAuth
Article Aug 10 2026

Idempotent Tool Calls for AI Agents: Prevent Duplicate Side Effects

Design idempotent AI-agent tool calls that stay safe under timeouts, retries, and duplicate delivery, with a persistent operation record and failure tests.

12 min read
Reliability · Agents · Distributed Systems
Article Aug 9 2026

Zero Trust Architecture for Autonomous AI Agents

Allowing AI agents autonomous access to production data is a security risk without strict isolation. Learn how to design a zero trust architecture for your agentic workflows.

8 min read
Architecture · Security · Agents
Article Aug 8 2026

Setting Up Local AI Models for CI/CD Pipelines: Cost and Privacy Benefits

Relying on cloud APIs for AI support in CI/CD is expensive and leaks code. Learn how to run local models in your pipelines for testing and static analysis.

4 min read
Architecture · CI/CD · Privacy
Article Aug 7 2026

Modeling AI Infrastructure Costs: Tokens, Storage, and Observability

When developers budget for an AI feature, they usually count the tokens and stop there. Build a technical cost model that includes vector databases, tracing, and orchestration.

6 min read
Architecture · Infrastructure · Budget
Article Aug 6 2026

The AI Feature Flag Rollout Plan: Ship AI-Written Changes Behind a Toggle

Approval decides what an AI agent may change. A flag decides who actually sees it: percentage rollout, a fast kill path, and flag hygiene so flags never become permanent technical debt.

9 min read
Feature Flags · Rollout · Production Safety
Article Aug 5 2026

AI Agent Rollback Plans: Approval Gates That Keep Production Recoverable

A practical approval gate for production agents: define the action boundary, require reviewable evidence, bind the decision to a small scope, and plan recovery before execution.

9 min read
Agents · Approval · Rollback
Article Aug 2 2026

The AI Queue & Background Job Migration Plan: Moving Heavy Work Safely

A 5-step plan for migrating synchronous HTTP workloads to asynchronous queues and background workers with AI — covering payload isolation, idempotency keys, DLQs, polling, and backpressure.

10 min read
Architecture · Queues · Idempotency
Article Jul 31 2026

The AI Performance Fix Plan: Measure Before You Let AI Optimize

A safer AI-assisted workflow for performance work: baseline on realistic data, locate the bottleneck with a profiler or explain plan, set a target and a price, change one thing, and re-measure identically.

16 min read
Performance · Profiling · Measurement
Article Jul 19 2026

The AI File Storage Migration Plan: Move Uploads Without Breaking Links

A safer AI-assisted workflow for moving uploads: inventory the full storage contract, copy with evidence, preserve access rules, reconcile live changes, and retire the old path deliberately.

11 min read
File Storage · Uploads · Reliability
Article Jul 17 2026

Migrate an Existing Background-Job Queue Without Losing Work

A safer AI-assisted workflow for queue changes: map stored work, prove producer-worker compatibility, preserve idempotency, drain deliberately, and retire the old path with evidence.

10 min read
Queues · Background Jobs · Reliability
Article Jul 15 2026

The AI Authentication Migration Plan: Change Login Without Locking Users Out

A safer AI-assisted workflow for auth changes: map the trust boundary, prove session and credential compatibility, stage rollout, and retire the old path with evidence.

10 min read
Security · Authentication · Migration
Article Jul 14 2026

The AI API Contract Change Plan: Evolve Endpoints Without Breaking Clients

A safer AI-assisted workflow for API changes: map consumers, prove old/new compatibility, stage an additive rollout, and retire the old contract with evidence.

9 min read
API · Compatibility · Reliability
Article Jul 13 2026

The AI Database Migration Plan: Change Schemas Without Guessing

A safer AI-assisted workflow for schema changes: map compatibility, stage expand-backfill-switch-contract, prove data invariants, and plan recovery.

8 min read
Database · Migration · Reliability
Article Jul 12 2026

The AI Dependency Upgrade Plan: Update Packages Without Guessing

A safer AI-assisted workflow for package upgrades: verify the version delta, map affected code, isolate the diff, define proof, and plan rollback.

7 min read
Dependencies · Maintenance · Testing
Article Jul 10 2026

The Intro-Pricing Trap: Budgeting AI Features on Promotional Prices

Promotional model pricing expires on a known date. Four guardrails: budget at list price, tag price-expiry dates, alert on unit cost, and pre-plan the downgrade.

6 min read
Cost · Budget · Planning
Article Jul 9 2026

AI Merge Readiness Checklist: 10 Questions Before You Approve

A practical pre-merge checklist for AI-assisted pull requests: 10 questions covering scope, tests, risk, rollout, and rollback before approval.

3 min read
Review · Risk · Workflow
Article Jul 5 2026

25 AI Code Review Comments That Actually Improve Diffs

25 copy-ready code review comments for AI-assisted diffs, grouped by correctness, security, tests, scope, and rollback — precise, not vague.

6 min read
Review · Templates · Reference
Article Jul 4 2026

AI Regression Test Plan Template

A copy-paste template for scoping regression tests around an AI-assisted change: what could break, which suites to run, and what to check by hand.

4 min read
Testing · Scope · Templates
Article Jul 4 2026

The AI Verification Ladder: Confidence Levels Before Merge

A practical way to match AI change risk to the right depth of validation, using five confidence levels before merge.

4 min read
Workflow · Testing · Review
Article Jul 3 2026

Model Fallback Runbook Template: The First 30 Minutes

A minute-by-minute runbook for the first 30 minutes of an AI provider outage: who acts, what to check, and when to declare the incident stable.

5 min read
Reliability · Incidents · Fallback
Article Jul 2 2026

AI PR Review Checklist Template for Engineering Teams

A copy-paste PR template that standardizes how your whole team reviews AI-assisted pull requests, so review quality doesn't depend on who's on call.

5 min read
Workflow · Team · Templates
Article Jul 2 2026

The AI Decision Log: Stop Re-Debating the Same Change

A practical way to keep AI coding work consistent across sessions: log key decisions, rationale, constraints, and checks so the next prompt starts from truth instead of guesswork.

5 min read
Workflow · Decision Log · Consistency
Article Jul 1 2026

AI Change Risk Matrix: Scope, Tests, Rollback Before Merge

A practical matrix for deciding how risky an AI-generated change is before merge, with scope, test depth, review evidence, and rollback requirements.

4 min read
Risk · Review · Rollback
Article Jul 1 2026

Run a Model Fallback Drill Before You Need One

A practical workflow for testing AI model fallback before an outage: trigger conditions, quality gates, rollback rules, and the one-page drill your team should run each month.

6 min read
Reliability · Fallback · Production
Article Jun 30 2026

15 Acceptance Criteria Examples for AI Coding Tasks

Copy-ready acceptance criteria examples for AI coding tasks: UI, API, data, auth, tests, refactors, migrations, and rollback.

9 min read
Criteria · Examples · Review
Article Jun 30 2026

Writing the Context File: AGENTS.md and CLAUDE.md Done Right

What belongs in an AI agent's context file and what doesn't: commands, architecture, conventions, and boundaries — plus how to keep it short, true, and maintained like code.

7 min read
Workflow · Context · Agents
Article Jun 29 2026

The AI Acceptance Criteria Prompt: Define Done Before the Diff

A practical way to define acceptance criteria before AI writes code, so reviews are based on clear pass/fail outcomes instead of opinions.

4 min read
Workflow · Review · Scope
Article Jun 28 2026

Running AI Agents in Parallel

A practical method for running two or three coding agents at once without losing control: task isolation, branch hygiene, one reviewer, and when parallel actually slows you down.

7 min read
Workflow · Multi-Agent · Review
Article Jun 25 2026

The AI Session Resume Packet

A practical way to make AI coding sessions resumable: capture goal, current state, decisions, changed files, open risks, validation, and the next prompt.

7 min read
Workflow · Handoff · Validation
Article Jun 24 2026

The AI Bug Report That Actually Helps

A practical structure for AI bug reports: observed behavior, expected behavior, reproduction path, relevant context, evidence, and fix boundaries.

6 min read
Debugging · Prompts · Validation
Article Jun 18 2026

When Your AI Model Gets Pulled: Building for Model Availability Risk

A practical framework for AI model availability risk: why models get pulled, deprecated, or restricted, and how to build features that survive losing one.

7 min read
Reliability · Vendor Risk · Production
Article Jun 17 2026

The AI Plan Before Code: Stop Letting AI Start in the Middle

A practical workflow for asking AI to plan before it edits: define intent, constraints, risks, validation, and rollback before accepting code changes.

7 min read
Planning · Review · Validation
Article Jun 13 2026

The AI Change Budget: How Much Should You Let AI Edit at Once?

A practical framework for deciding how large an AI-generated change can be before reviewability, tests, rollback, and production risk say to split it.

8 min read
Workflow · Review · Scope
Article Jun 7 2026

Why Small Diffs Win With AI

Broad rewrite prompts feel fast, but small diffs plus tight validation loops usually produce better AI-assisted code with less cleanup.

6 min read
Workflow · Iteration · Quality
Article Jun 6 2026

The AI Code Ownership Checklist: Before You Merge

A practical merge checklist for AI-generated code: behavior, tests, contracts, edge cases, security, and observability.

6 min read
Quality · Review · Production
Article Jun 3 2026

The True Cost of Context: Why Context Dumping is an Anti-Pattern

Large context windows make it easy to include everything, but more context is not always better. Why targeted context curation improves quality, speed, and cost when coding with AI.

6 min read
Prompting · Context · Quality
Case Study May 26 2026

Case Study: Refactoring Legacy Authentication with AI

A concrete example of using AI to modernize an undocumented legacy authentication controller. From the initial messy state to a clean, tested, and validated result.

2 min read
Diff · Testing · Results
Article Apr 25 2026

Why AI Code Feels Fast But Fragile

AI-generated code can make the first hour feel magical, then become brittle when edge cases, tests, integration, and maintenance arrive. Here's how to keep the speed without losing the structure.

11 min read
Quality · Testing · Maintainability
Article Apr 22 2026

Should This Feature Use AI?

A practical decision framework for when AI belongs in a product feature, when ordinary code is better, and how to keep probabilistic systems away from decisions that need deterministic control.

13 min read
Decision Framework · Product · Production
Case Study Mar 21 2026

How This Site Was Built: A Developer and AI, Start to Finish

The full story of building aiprogrammingmanual.com — one developer and Claude, over 6 weeks. What worked, what went wrong, and what I'd do differently.

13 min read
Case Study · Behind the Scenes
Article Mar 20 2026

How AI APIs Work (And Why You're Already Using Them)

Every time you use Claude or ChatGPT, an API is doing the work behind the scenes. What's actually happening, how tokens and pricing work, and why this one concept explains the entire AI tool landscape.

7 min read
Concepts · Practical · Accessible
Article Mar 17 2026

Where Vibe Coding Is Actually Going

Vibe coding is moving toward agent supervision and multi-tool workflows, but product judgment, review, security, and maintenance still decide what survives.

12 min read
Perspective · Analysis · Honest
Article Mar 15 2026

How AI Models Are Trained: What's Actually Happening

The training process behind Claude, ChatGPT, and other AI tools — explained in plain language. Why AI hallucinates, why it writes outdated code, and why context improves results so dramatically.

12 min read
Concepts · Behind the Scenes
Article Mar 14 2026

How AI Programming Is Different From Traditional Development

Deterministic code vs probabilistic systems, writing rules vs providing data, and why debugging AI feels completely different. What changes when you move from traditional software to AI-assisted development.

9 min read
Concepts · Comparison · Practical

What changed in the AI stack — filtered for developers and vibe coders. No hype, no consumer app coverage. Model releases, API changes, and what they mean for how you build.

News Aug 24 2026

OpenAI Regional Processing Per Request: Route One Call to the EU

One Global-project API key can now select global, US, or EU processing per request. The base-URL change, eligibility gates, support matrix, and negative tests to add before rollout.

8 min read
OpenAI API · Regional Processing · Data Controls
News Aug 23 2026

Computer Use Goes GA — and the Browser Toolset That Reads the Page Instead

The GA toolset rejects five parameters the beta tool accepted, and coordinates move into the screenshot you return. Plus when to address elements by reference instead of by pixel.

9 min read
Claude API · Tool Use · Migration
News Aug 22 2026

Anthropic Python SDK 1.0: The Migration That Removes temperature, top_p, and top_k

Version 1.0 raises the Python floor to 3.10 and swaps httpx for httpx2. Apply the five breaking changes in order, and check your mocks before you trust a green test run.

8 min read
Python · Anthropic SDK · Migration
News Aug 21 2026

Private Claude Code Plugin Marketplaces: Short-Lived Auth with headersHelper

Claude Code 2.1.238 can mint HTTP headers for private URL marketplaces and plugin archives. Choose catalog or entry scope, preserve confirmation, and test every fetch path.

9 min read
Claude Code · Plugins · Security
News Aug 20 2026

The Claude API Beta Headers That Just Went GA: What Removing Them Changes

Files, Skills, and Enterprise user management are GA on the Claude API. Two of the three beta headers are free to delete; the third quietly changes the shape of every GET /v1/files response.

11 min read
API Contracts · Claude API · Files API
News Aug 18 2026

OpenAI's Assistants API Shuts Down August 26: The Migration Checklist

Assistants, threads, and runs map onto the Responses and Conversations APIs. Where the retention floor moves, why the recommended prompt-object step shuts down 96 days later, and what to export before the endpoint stops answering.

9 min read
API Migration · OpenAI · Deprecation
News Aug 17 2026

Claude Code's Subagent Forking Default: What Changes for Your Multi-Agent Setup

Claude Code 2.1.232 makes a subagent_type "fork" subagent inherit the full parent conversation and prompt cache by default. Where the cost assumption moved, where context can leak between subagents, and what to check in an existing config.

12 min read
Agent Tooling · Subagents · Claude Code
News Aug 15 2026

Your Local Claude Code Sessions Are Now Retrievable by Your Organization

Three Compliance API endpoints, in beta for Claude Enterprise organizations, return transcripts of Cowork and Claude Code sessions run on users' own machines. What lands in the transcript, who can pull it, and what to change locally.

14 min read
Governance · Compliance API · Claude Code
News Aug 14 2026

Imagen 4 Shuts Down August 17: Migrate the Model ID Without Breaking Image Output

Three Imagen 4 endpoints are scheduled to shut down. Replace the request and response contract, then prove bytes, MIME type, dimensions, failures, and visual acceptance before cutover.

6 min read
Model Migration · Gemini API · Verification
News July 27 2026

Claude Opus 5 Keeps the Price and Changes the Bill

Opus 5 shipped July 24 at Opus 4.8's exact list price. Underneath it, thinking is on by default, the effort dial is the main cost control, and two prompt-cache rules moved in opposite directions.

7 min read
Model Release · Anthropic · Cost
News July 15 2026

Microsoft's CLI Agent Rollout: 24% More Merged PRs, With a Catch

A new field study of Microsoft's early-2026 rollout of Claude Code and GitHub Copilot CLI found roughly 24% more merged PRs among adopters, while showing why teams need better rollout metrics than raw output.

5 min read
CLI Agents · Microsoft · Productivity
News July 11 2026

GPT-5.6 Goes GA: The Locked Preview Opens Two Weeks Later

OpenAI made GPT-5.6 Sol, Terra, and Luna generally available on July 9, 2026, after a 13-day limited preview. GA pricing, ultra mode with four parallel agents, and programmatic tool calling in the Responses API.

5 min read
Model Release · OpenAI · Agents
News June 29 2026

GPT-5.6 Sol Launches in a Locked Preview: The Best Coding Model You Can't Use Yet

OpenAI previewed GPT-5.6 Sol on June 26, 2026 — a new state of the art on Terminal-Bench 2.1, with an ultra mode that runs subagents. But access is limited to a small set of partners after the U.S. government reviewed the launch.

5 min read
Model Release · OpenAI · Agents
News June 26 2026

Windsurf Is Now Devin Desktop: What Changes Before Cascade's July Cutoff

Cognition retired the Windsurf brand on June 2, 2026, relaunching it as Devin Desktop with an Agent Command Center and ACP support. Cascade, Windsurf's local agent, remains available through July 2026.

4 min read
Tools · Editors · Agents
News June 22 2026

Claude Fable 5's Free Window Ends While Access Is Still Suspended

Fable 5's no-extra-cost subscription window ended June 22. As of June 28, Anthropic's access statement still says Fable 5 and Mythos 5 were removed from all users while access is restored.

4 min read
Pricing · Model Release · Claude
News June 14 2026

OpenCode Crosses 160,000 Stars: Inside the Model-Agnostic CLI Agent

The open-source terminal agent OpenCode crossed 160K+ GitHub stars and 7.5M monthly active developers, with support for 75+ model providers and a fast release cadence (v1.16.0 in early June, v1.17.x soon after) — what its provider-agnostic, BYOK approach means for your CLI workflow.

5 min read
Tools · CLI · Open Source
News June 4 2026

Claude Opus 4.8 Reaches 88.6% on SWE-bench Verified

Anthropic's latest Opus release reports an 88.6% SWE-bench Verified score, with stronger agentic coding behavior, dynamic workflows, and better uncertainty signaling.

4 min read
Model Release · Benchmarks · Agents
News June 1 2026

Codex in Production: Self-Improving Agents and Eval Loops

OpenAI's latest engineering case study shows a concrete production pattern: expert feedback becomes traces, traces become eval targets, and Codex helps ship bounded improvements with human review.

5 min read
Engineering · Agents · Loops
News May 29 2026

Claude Opus 4.8: 1M Context, Adaptive Thinking, Dreaming Agents

What actually changed in Claude Opus 4.8 for developers. 1M token context is now default. Adaptive thinking cuts wasted reasoning tokens. Dreaming gives agents persistent memory between sessions.

4 min read
Model Release · API · Agents
News May 26 2026

The Multi-Agent Coding Stack: Cursor, Claude Code, Codex

The era of one AI coding tool is over. Many senior developers now run 2–3 tools in parallel. Cursor 3.2 ships /multitask for parallel subagents. Zed 1.0 adds the Agent Client Protocol.

5 min read
Tools · Workflow · Agents
News May 21 2026

Google I/O 2026: The Developer Edition

Everything from Google I/O that actually matters for developers: Gemini 3.5 Flash, Antigravity 2.0 subagents, the Managed Agents API, WebMCP, and Android CLI 1.0 — stripped of the keynote hype.

5 min read
Platform · Models · APIs
News

All News →

Browse the full news archive.