feat: generate-spec command article

[sobanieca-redocly]

What/Why/How?

A new article for generate-spec command in Redocly CLI. To be published once drift article lands (#332) and when
generate-spec command is released (Redocly/redocly-cli#2937)

Reference

Testing

Screenshots (optional)

Check yourself

• Code is linted
• Tested
• All new/updated code is covered with tests

Security

• Security impact of change has been considered
• Code follows company security practices and guidelines

[redocly]

marketing-site AI Review: 🟢 Completed

Redocly Agent has reviewed your changes and found 3 potential issue(s).

Note

Low Risk

This PR only adds a new blog post and does not modify any source code or application logic, meaning there is no operational or system risk.

Overview

Adds a new article (blog/generate-openapi-from-traffic.md) detailing the upcoming generate-spec command for the Redocly CLI. The post explains how to:

• Deterministically generate baseline OpenAPI descriptions from recorded HTTP traffic (like HAR files).
• Use the proxy command to capture traffic and consider safety implications regarding sensitive data.
• Refine the generated descriptions with AI using the --with-ai flag and supported providers (Claude, Codex, Cursor).

[RomanHotsiy]

I think what we miss is some kind of comparison of --with-ai mode vs regular one or vs other open-source tools in this area.

[sobanieca-redocly]

Added comparison with and without AI. Only for our case now, without comparison against other open source tools. I think comparison with other open source tools would be beneficial for separate article? Here we introduce a new tool in our stack. Otherwise the article will get quite long.

Also, I don't see that many OSS tools that do similar things. Need to dig further. One candidate I've found: https://apisyouwonthate.com/blog/turn-http-traffic-into-openapi-with-optic/ but it doesn't have --with-ai option.

[sobanieca-redocly]

Date to be updated when merging