DEV Community

Jeff profile picture

Jeff

404 bio not found

Joined Joined on 
Your Agent Writes the PR Description, but It Only Tells You What the Code Does

Your Agent Writes the PR Description, but It Only Tells You What the Code Does

Comments 1
3 min read

Want to connect with Jeff?

Create an account to connect with Jeff. You can also sign in below to proceed if you already have an account.

Already have an account? Sign in
Your Agent Keeps Asking the Same Question It Already Answered Last Session

Your Agent Keeps Asking the Same Question It Already Answered Last Session

Comments
3 min read
Your Agent Will Refactor a Working Function and Quietly Drop the Edge Case

Your Agent Will Refactor a Working Function and Quietly Drop the Edge Case

Comments
3 min read
Your Agent Breaks the Dockerfile Because It Has Never Seen CI Run

Your Agent Breaks the Dockerfile Because It Has Never Seen CI Run

Comments
2 min read
Long Agent Sessions Rot — Start Fresh Instead of Scrolling Back Up

Long Agent Sessions Rot — Start Fresh Instead of Scrolling Back Up

Comments
3 min read
Your AGENTS.md Should Survive a Tool Switch

Your AGENTS.md Should Survive a Tool Switch

Comments
4 min read
Every Agent Task Should End With a Command You Can Run

Every Agent Task Should End With a Command You Can Run

Comments
3 min read
Stop Pasting Your Whole Repo Into the Agent

Stop Pasting Your Whole Repo Into the Agent

Comments
3 min read
Your Agent Is Fixing Flaky Tests by Quietly Weakening Them

Your Agent Is Fixing Flaky Tests by Quietly Weakening Them

1
Comments 4
3 min read
Your MCP Server Is Wasting Your Agent's Context Window

Your MCP Server Is Wasting Your Agent's Context Window

1
Comments 2
3 min read
Your AI Wrote a Test That Only It Can Pass

Your AI Wrote a Test That Only It Can Pass

Comments
3 min read
Your AI Review Bot Reviewed a Diff the AI Itself Wrote. That's Not a Review.

Your AI Review Bot Reviewed a Diff the AI Itself Wrote. That's Not a Review.

Comments 2
3 min read
Your Agent Doesn't Need More Tokens. It Needs Fewer Wrong Files.

Your Agent Doesn't Need More Tokens. It Needs Fewer Wrong Files.

Comments
2 min read
When AI Starts Writing Your System, Who Tells It What 'Done' Means?

When AI Starts Writing Your System, Who Tells It What 'Done' Means?

Comments 1
3 min read
Ask AI to Draw the Failure Path Before You Approve the PR

Ask AI to Draw the Failure Path Before You Approve the PR

Comments
3 min read
Your API Bug Report Is Missing the Caller

Your API Bug Report Is Missing the Caller

Comments
2 min read
Give Your API Agent a Definition of Done

Give Your API Agent a Definition of Done

Comments
3 min read
Your JSON Is Valid. Your Content-Type Might Not Be.

Your JSON Is Valid. Your Content-Type Might Not Be.

Comments
3 min read
Your API Works in cURL. Why Does the Browser Reject It?

Your API Works in cURL. Why Does the Browser Reject It?

Comments
3 min read
MCP Connects Agents to Tools. A2A Connects Agents to Agents - Here's How to Debug It.

MCP Connects Agents to Tools. A2A Connects Agents to Agents - Here's How to Debug It.

Comments
6 min read
Turn an Existing REST API into an MCP Server Without Writing a Single Wrapper

Turn an Existing REST API into an MCP Server Without Writing a Single Wrapper

1
Comments
5 min read
Stop Pasting API Docs into Your AI Coding Assistant. Give It an MCP Server Instead.

Stop Pasting API Docs into Your AI Coding Assistant. Give It an MCP Server Instead.

1
Comments
5 min read
I Scanned Dozens of Real Backends into OpenAPI. Here's Why the Naive Approaches Fail.

I Scanned Dozens of Real Backends into OpenAPI. Here's Why the Naive Approaches Fail.

Comments
6 min read
Stop Testing Your API With the Same Perfect Request

Stop Testing Your API With the Same Perfect Request

1
Comments
3 min read
The Most Useful API Review Starts With a Diff, Not a Demo

The Most Useful API Review Starts With a Diff, Not a Demo

2
Comments
3 min read
Your cURL Command Works. That Doesn't Make It API Documentation.

Your cURL Command Works. That Doesn't Make It API Documentation.

Comments
3 min read
Your Cancel Button Might Only Be Canceling the Spinner

Your Cancel Button Might Only Be Canceling the Spinner

1
Comments
4 min read
I Would Rather See Unknown Than an AI-Invented API Contract

I Would Rather See Unknown Than an AI-Invented API Contract

1
Comments
4 min read
Your API Returned 200. Your Integration Is Still Broken.

Your API Returned 200. Your Integration Is Still Broken.

Comments
3 min read
Validate HTTP requests and responses against OpenAPI at runtime: middleware, proxies, and fail-open vs fail-closed

Validate HTTP requests and responses against OpenAPI at runtime: middleware, proxies, and fail-open vs fail-closed

Comments
6 min read
A2A streaming and the task lifecycle: SSE progress updates, artifacts, and push notifications

A2A streaming and the task lifecycle: SSE progress updates, artifacts, and push notifications

Comments
6 min read
Multiple security schemes in OpenAPI: AND vs OR, optional auth, and per-operation overrides

Multiple security schemes in OpenAPI: AND vs OR, optional auth, and per-operation overrides

Comments
5 min read
Health checks for APIs: /healthz, /readyz, /livez, version, and metrics in OpenAPI

Health checks for APIs: /healthz, /readyz, /livez, version, and metrics in OpenAPI

Comments
5 min read
OpenAPI docs renderers compared: Swagger UI, Redoc, Scalar, Stoplight Elements, and RapiDoc on one spec

OpenAPI docs renderers compared: Swagger UI, Redoc, Scalar, Stoplight Elements, and RapiDoc on one spec

Comments
6 min read
Enforce an API style guide in CI with Spectral: custom rules that stop bad OpenAPI before it merges

Enforce an API style guide in CI with Spectral: custom rules that stop bad OpenAPI before it merges

Comments
5 min read
OpenAPI servers and server variables: local, staging, production, regions, and per-tenant hosts from one spec

OpenAPI servers and server variables: local, staging, production, regions, and per-tenant hosts from one spec

Comments
5 min read
operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

operationId and tags in OpenAPI: naming conventions that keep generated SDKs and docs usable

Comments
5 min read
Deprecating an API without breaking clients: Deprecation and Sunset headers, successor-version, and OpenAPI

Deprecating an API without breaking clients: Deprecation and Sunset headers, successor-version, and OpenAPI

Comments
5 min read
File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses

File downloads in OpenAPI: CSV, PDF, ZIP, images, Content-Disposition, and non-JSON responses

Comments
5 min read
Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands

Designing a search endpoint in OpenAPI: q, filters, sorting, sparse fieldsets, and pagination codegen understands

Comments
5 min read
Long-running REST APIs: 202 Accepted, Location, job status polling, and webhooks in OpenAPI

Long-running REST APIs: 202 Accepted, Location, job status polling, and webhooks in OpenAPI

Comments
5 min read
Bulk and batch API endpoints: modeling create-many, partial success, and 207 Multi-Status in OpenAPI

Bulk and batch API endpoints: modeling create-many, partial success, and 207 Multi-Status in OpenAPI

Comments
5 min read
Idempotency-Key in practice: retrying POSTs safely, deduping concurrent requests, and documenting it in OpenAPI

Idempotency-Key in practice: retrying POSTs safely, deduping concurrent requests, and documenting it in OpenAPI

Comments
5 min read
Dates, times, and time zones in OpenAPI: date-time, date, duration, and the timezone mistakes that shift bookings

Dates, times, and time zones in OpenAPI: date-time, date, duration, and the timezone mistakes that shift bookings

Comments
5 min read
Modeling money and big integers in OpenAPI: int64 precision, decimal amounts, and why number fails for currency

Modeling money and big integers in OpenAPI: int64 precision, decimal amounts, and why number fails for currency

Comments
5 min read
readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields

readOnly and writeOnly in OpenAPI: one schema for create, response, and password fields

Comments
5 min read
OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types

OpenAPI additionalProperties: modeling maps, dictionaries, labels, and free-form objects without losing types

Comments
5 min read
Recursive and cyclic schemas in OpenAPI: self-referencing $ref for trees, nested comments, and graphs

Recursive and cyclic schemas in OpenAPI: self-referencing $ref for trees, nested comments, and graphs

Comments
5 min read
OpenAPI enums vs const: closed lists, open-ended strings, and how to add a value without breaking clients

OpenAPI enums vs const: closed lists, open-ended strings, and how to add a value without breaking clients

Comments
5 min read
Optional, nullable, or omitted? Modeling missing data in OpenAPI 3.1 without lying to clients

Optional, nullable, or omitted? Modeling missing data in OpenAPI 3.1 without lying to clients

Comments
5 min read
PUT vs JSON Merge Patch vs JSON Patch: modeling partial updates in OpenAPI without the null ambiguity

PUT vs JSON Merge Patch vs JSON Patch: modeling partial updates in OpenAPI without the null ambiguity

Comments
5 min read
OpenAPI callbacks vs webhooks: modeling async request/reply with runtime expressions

OpenAPI callbacks vs webhooks: modeling async request/reply with runtime expressions

Comments
5 min read
The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them

The JSON Schema constraints that actually work in OpenAPI: format, pattern, ranges, and what codegen and AI mocks do with them

Comments
5 min read
Model polymorphism in OpenAPI 3.1: oneOf, anyOf, allOf, and discriminator without breaking clients

Model polymorphism in OpenAPI 3.1: oneOf, anyOf, allOf, and discriminator without breaking clients

Comments
4 min read
Document rate limits in OpenAPI so clients actually back off: 429, Retry-After, and rate-limit headers

Document rate limits in OpenAPI so clients actually back off: 429, Retry-After, and rate-limit headers

Comments 1
5 min read
Prevent lost updates with ETag and If-Match: optimistic concurrency in OpenAPI

Prevent lost updates with ETag and If-Match: optimistic concurrency in OpenAPI

Comments
4 min read
File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

File uploads in OpenAPI: multipart/form-data, raw binary, and multiple files done right

Comments
5 min read
Stop letting examples lie: make your OpenAPI spec the single source of truth for docs, mocks, and agents

Stop letting examples lie: make your OpenAPI spec the single source of truth for docs, mocks, and agents

Comments
4 min read
REST API versioning in 2026: paths vs headers, additive changes, and OpenAPI diffs in CI

REST API versioning in 2026: paths vs headers, additive changes, and OpenAPI diffs in CI

Comments 3
4 min read
Document API authentication in OpenAPI 3.1: Bearer, API keys, OAuth 2, and mTLS without the usual mistakes

Document API authentication in OpenAPI 3.1: Bearer, API keys, OAuth 2, and mTLS without the usual mistakes

Comments
4 min read
loading...