#contractfirst — Public Fediverse posts

Назад в 2005-й. API-first как третья пилюля от деградации проекта под LLM

Агент отчитался: экран настроек готов. Поля редактируются, после сохранения выскакивает тост «Сохранено». Я нажал F5 — все настройки вернулись к дефолтным. Бэкенда под формой не существовало: агент выяснил это в первые минуты и вместо того, чтобы сказать мне, молча положил данные в локальный стейт и нарисовал тост. Ни один чекер из моих прошлых статей этого не поймал — и не мог: деградация пришла со шва между фронтом и бэкендом, единственной границы, через которую не проходит ни компилятор, ни анализатор зависимостей. Под катом — как этот шов гниёт под LLM и как его чинит contract-first: генерация серверных интерфейсов и клиента из одного OpenAPI-файла, политика ломающих изменений, правило «не симулируй — расширяй контракт». Попутно — зачем возвращаться к идее, которую мы выбросили вместе с WSDL, и какая из моих проверок после всего этого молча перестала работать. Третья часть цикла, читается самостоятельно.

https://habr.com/ru/articles/1063096/

#llm #aiагенты #claudecode #vibecoding #чистая_архитектура #openapi #apifirst #contractfirst #кодогенерация #archunit

@odrotbohm My advice for years has been that if you feel like you need GraphQL, your API is designed poorly and you should fix the API. #ContractFirst, #OpenAPI, and #APIContracts should have been used for the UI/UX people to communicate with the backend team what they need, when, and how much.

@odrotbohm My advice for years has been that if you feel like you need GraphQL, your API is designed poorly and you should fix the API. #ContractFirst, #OpenAPI, and #APIContracts should have been used for the UI/UX people to communicate with the backend team what they need, when, and how much.

I get to practice #DesignThinking combined with #ContractFirst #API development again this week and it always makes me feel so good to see a #UserExperience come together quickly. #UX #OpenAPI It amazes me how quickly and effectively it comes together.

I get to practice #DesignThinking combined with #ContractFirst #API development again this week and it always makes me feel so good to see a #UserExperience come together quickly. #UX #OpenAPI It amazes me how quickly and effectively it comes together.

@fxnn Let me rephrase what I wanted to say: a) it’s not a proposal, but a description what we do
b) using #contractfirst we don’t rely on a generated OpenAPI, but a complete edited one (using apicur.io as tool, nobody wants to manually maintain huge YAML files). It comes with prose for human consumption and examples exercisable in Postman and Swagger. Imho close enough

@fxnn Let me rephrase what I wanted to say: a) it’s not a proposal, but a description what we do
b) using #contractfirst we don’t rely on a generated OpenAPI, but a complete edited one (using apicur.io as tool, nobody wants to manually maintain huge YAML files). It comes with prose for human consumption and examples exercisable in Postman and Swagger. Imho close enough

@mfowler For http based APIs we use tools like Postman including tests to demo. New APIs we base on OpenAPI which lends itself to a Swagger UI and if properly fleshed out ( shoutout to https://apicurio.io ) documentation too #OpenAPI #swagger #contractfirst

@mfowler For http based APIs we use tools like Postman including tests to demo. New APIs we base on OpenAPI which lends itself to a Swagger UI and if properly fleshed out ( shoutout to https://apicurio.io ) documentation too #OpenAPI #swagger #contractfirst

Interested in getting a jump on the content for my #JFokus talk about #APIs, #OpenAPI, and #ContractFirst? Head over to https://appdev.consulting.redhat.com/tracks/contract-first/ to watch and follow some of our tutorials which should help you build APIs faster, with higher quality, and less rework!

Interested in getting a jump on the content for my #JFokus talk about #APIs, #OpenAPI, and #ContractFirst? Head over to https://appdev.consulting.redhat.com/tracks/contract-first/ to watch and follow some of our tutorials which should help you build APIs faster, with higher quality, and less rework!

Yet another exciting announcement! I will be speaking at #JFokus in February about #APIs, #ContractFirst, #DesignThinking, and how to help you deliver more effectively. #Java #OpenAPI

Yet another exciting announcement! I will be speaking at #JFokus in February about #APIs, #ContractFirst, #DesignThinking, and how to help you deliver more effectively. #Java #OpenAPI