Please… Enough with the Sloppy, One-Shot SaaS Replacements — Mahmoud Abdelwahab, Railway
Read the Portuguese translation →
Author: AI Engineer · Watch on YouTube
Video authored by the channel shown, not by IANIA; all rights belong to the creator. Transcript and summary generated automatically; the original-language content is preserved.
Original language: English
Original video: Please… Enough with the Sloppy, One-Shot SaaS Replacements — Mahmoud Abdelwahab, Railway · Channel: AI Engineer · 13:01 · Watch on YouTube
Topics: AI agents, Enterprise AI applications, Task and workflow automation, Software engineering with AI, AI developer tools
Summary
Section titled “Summary”Mahmoud Abdelwahab describes building an agent-powered internal marketing tool at Railway to replace several SaaS products, and argues that working software is not automatically polished software people enjoy using. He explains how a well-structured codebase and reusable patterns help agents produce consistent features. He lists product details agents may omit unless asked, including autosave, optimistic updates, undo, archiving, URL state, and infinite scroll. His final recommendations are to package preferences as agent skills and have agents verify features end to end.
Key points
Section titled “Key points”- There is a significant gap between software an agent can build in one shot and software that feels polished and pleasant to use.
- A properly structured codebase with solid abstractions helps agents follow existing patterns and produce consistent features.
- Agents may need explicit instructions to implement everyday usability features such as autosave, safe handling of unsaved changes, and real-time collaboration.
- Optimistic updates can make interactions feel faster, while undo gives users a way to reverse actions before they take effect.
- Archiving offers an alternative to deleting records, and URL state makes filters and sorting easy to share.
- Infinite scroll can improve the experience of frequently used lists.
- Using existing pages as references helps agents match established UI, data-fetching, and structural patterns.
- Packaging design and deployment preferences as agent skills helps agents apply them across features.
- End-to-end verification matters because a successful build or test does not guarantee that a feature works in practice.
Chapters
Section titled “Chapters”| Start | Chapter | Summary |
|---|---|---|
| 00:00 | Why one-shot SaaS replacements fall short | Mahmoud introduces the gap between software that works and polished software people want to use, then describes Railway’s internal marketing tool. |
| 02:05 | Codebase structure and consistent patterns | He explains why a well-structured codebase helps agents extend an app consistently and introduces the importance of thoughtful product details. |
| 04:09 | Product patterns agents need to be asked for | He covers autosave, real-time collaboration, optimistic updates, undo, archiving, URL state, and infinite scroll. |
| 09:22 | References and agent skills | He recommends using existing pages as references and packaging design and Railway-specific preferences as agent skills. |
| 11:27 | Verify features end to end | He emphasizes having agents run and test features in practice, then concludes that these principles can help produce polished internal tools. |
Quotes
Section titled “Quotes”there’s a gap, a big gap between working software that got oneshotted and software I would actually use. — 00:00
autosave is kind of like a table stakes feature. — 04:40
having optimistic updates makes the overall experience feel significantly faster, much snappier — 06:16
once you have like a verification loop in place, it’s like a night and day difference — 11:59
build your own internal tools that feel good, that are polished, and spark joy. — 13:01
Concepts and entities
Section titled “Concepts and entities”Mahmoud Abdelwahab, Railway, GPT-6, TanStack, Payload, Agent Skills, atualizações otimistas, verificação de ponta a ponta
Full transcript (original language)
Section titled “Full transcript (original language)”00:00 People have been saying that SAS is dead for a while now. It’s not even a hot take at this point. Why pay someone to build and maintain the tools you use when you could just do it yourself? Just ask your agent to do it. And for me, there’s one missing piece that rarely gets mentioned. And it’s the fact that there’s a gap, a big gap between working software that got oneshotted and software I would actually use. Software that sparks joy, that is polished, that feels good. and actually went on a journey to replace a bunch of SAS providers we’re using internally at
00:31 Railway for marketing purposes. And I just built an all-in-one tool that we use. The tool allows us to manage content for the Railway website, change log, blog. We can use it to send emails, post on all of our social platforms at the same time, manage the website’s media. There’s even a mini CRM so that when we’re working with like external creators, we can keep track of that. There is task tracking, launch planning because you know you want to coordinate multiple things and when they’ll go out. There’s a calendar and at the same time there’s like comments, realtime editing
01:02 and it’s all built using agents. I would say I felt the breakthrough when GPT6 came out and all of this is running on railway. Everything just auto deploys. And let me essentially now walk you through the principles I use to actually make sure that when I want to add a feature, it’s, you know, actually polished and matches the rest of the app and at the same time the principles that you can pull from and apply when building tools of your own. So instead
01:33 of doing my talk from my boring office, I decided to switch things up and do it outside. It is absolutely beautiful. Right now I’m in Edinburgh, Scotland, and it’s just unreal. Like I’m on a bench outside and this is my view. Definitely a 10 out of 10 bench. Now this type of talk for me feels a little bit different than what I’m used to because I essentially will walk you through the journey of me building our own internal tools and the opinions I’ve developed. But I also understand that
02:05 the landscape changes very very quickly. So like anything I say might change completely in like the span of months. Who knows? So I don’t know. Consider this my disclaimer. Like but the time of recording is fall 2026. It’s October. And yeah. So anyway, with that out of the way, uh let’s talk about the first point which is texts don’t matter. Now, a lot of people say that it doesn’t matter what programming language you
02:36 use, what framework you use. You can just ask your agent to build you anything and build it is able to do it. And while I agree to some extent, what I found is when you’re building a tool that you will actually use, when you give the agent a proper codebase with solid abstractions, what ends up happening is whenever you’re working, let’s say, on a new feature, you end up with a much more consistent result that is similar to what you’ve already built before. And the reason is like it’s very simple. the agent doesn’t need to
03:08 reinvent the same like wheel every time it tries to add a new feature or it doesn’t need to introduce new patterns. It will just essentially follow existing patterns. And when it comes to like what you choose, I feel like it kind of doesn’t really matter as long as you have a code base that is properly structured. But like my go-to choice today is one tan stack libraries for anything when building on the web. And if you’re building anything content related, I would say definitely go with
03:38 payload. Solid experience, great abstraction. I went down like a big rabbit hole of like comparing CMSS at some point because I don’t believe that I should uh build it from scratch even though I can. But again, who knows? Maybe the future will change. But yeah, and that’s kind of like the main first item that I kind of ran into. When you use like a lot of SAS products out there that you actually love that you use every day,
04:09 when you’re a user, there’s like a lot of things you don’t notice, but when you actually try to like replicate an experience, you quickly find out how much care and thought goes into different flows. So like something as simple as oh I want to be able to send an email or to publish something. You can easily do it by having like a good old you know just like server side rendered app with like forms that you submit. But if you try to build something that is going to be used every
04:40 day that you will reach for a lot you’re like oh it shouldn’t feel that way. And there are kind of like a bunch of patterns that I found that agents don’t typically do unless you explicitly ask them to. And this is my list. So we’ll go through them one by one. And the first one is like autosave. I found that if like let’s say I’m building some form of document editor, autosave is kind of like a table stakes feature. So rather than manually clicking save to save
05:13 things, you just ask it to automatically save progress in the background and to make sure that it’s like a non-blocking action so that you can let’s say if as you’re typing you’re able to type and then it just automatically saves. And one other kind of like step further that you could do is to also prevent the browser tab from closing if there are unsafe changes. So it’s kind of like this these two layers that kind of guarantee that whatever it is that
05:44 you’re working on is just not going to be lost. Now you can also go a step further and to add like real-time collaboration so that you can have like concurrent edits. And again, my agent didn’t struggle at all with adding the feature. It was like, I don’t know, asking about it, reviewing how it would work, and then once that’s done, >> just 700 million tokens later, I had real time. So, I would say in general, this is the first thing that I find agents just don’t do well from a product
06:16 experience perspective. Another pattern I found that agents completely forget to implement is optimistic updates. So rather than showing your users a bunch of loading spinner whenever they’re taking any action, you essentially show them the success state you know optimistically and in the background you’re going to sync whatever change they made. Now if the sync or the operation fails for whatever reason you just roll it back and then tell them like oh the operation work. Now of course you shouldn’t blindly have optimistic updates for
06:46 everything. There are some scenarios where you want to show the user a loading spinner and you’re going to wait to check that everything worked properly. But in general, having optimistic updates makes the overall experience feel significantly faster, much snappier, and it will just feel much more instant. So pretty sure you can just ask your agent like, “Hey, I would like to implement optimistic updates where it makes sense. Let’s come up with a plan.” And it will tell you all the areas where it makes sense to do. Again, it’s like it’s not difficult for the agent to build it. You just need
07:19 to ask and know exactly what to ask for. Now, an extension of optimistic updates, in my opinion, is giving users the ability to undo certain actions. Now, for example, if you ask your agent to implement the ability to delete records, what it will typically do is it will give you a delete button. You click it, might show a confirmation dialogue, you hit confirm, and then it will actually do the deletion. But a much nicer experience is actually allowing the user to undo that action. So they hit delete,
07:49 you immediately remove the item they want to delete from the UI, but you tell them like, hey, you have like a couple of seconds where you could change your mind. And if they don’t do anything, that means you actually want to delete a thing. Then you actually implement the operation. Otherwise, if they hit undo, you just bring back the change. So it’s kind of like you do the operation in the background as well. It’s just kind of a delayed action which kind of ties into the next point which is archiving. You
08:20 should tell your agent you want the ability to archive records and be able to unarchive them because sometimes you want to hide something from the UI completely or let’s say from search results and archiving will be the way to do it and you shouldn’t force your user to be like well if you don’t want to see this you have to delete it. and a much better experience is just the ability to walk out records. So I think it is a pattern that should definitely exist. Another big one for me is URL state. you should ask your agent to persist in the URL whenever it makes sense of course
08:51 and it’s so useful because whenever you have let’s say a list of records and you want the ability to filter or sort them and you just have a bunch of like conditions maintaining these things in the URL makes it trivial for you to give them to someone else and then let’s say another team member is just going to be able to see exactly what you want them to see now another small detail that agents don’t implement out of the box is infinite scroll I don’t want to be clicking on load more over and over and over or like a next page button as I
09:22 scroll I should just get the data I shouldn’t need to click next page and then in the end I’ll just see that oh I’ve reached the end it’s a very minor thing but also when you use something every day I think it makes a huge difference now another pattern I found that made the output significantly better is telling the agent explicitly to use existing pages as references when it comes to the UI the data fetching and how it works works and how the thing is overall structured and that made it possible for me to essentially define
09:53 what good looks like once and then just reuse it for more features. Now to be completely honest sometimes even when you tell the agent like hey use page X as a reference sometimes it just doesn’t follow it. I don’t know if models like get dumber sometimes but sometimes it does happen. But overall, I would say that my success rate is higher whenever I tell the agent to like, well, use an existing page as a reference because you also just end up with a more consistent experience. So like as you’re using your
10:24 app, you’re like, oh, this just matches the other part of the app if they both share like the same concept. So like if two parts of the app are essentially lists of records that you can create update and delete and like list well both of these parts should be pretty much identical. This list kind of brings me to my next point which is whenever you have opinions about something they should be packaged as agent skills and then this way your agent whenever it’s building something it will actually follow those skills pretty closely. And
10:56 as I was building all of our internal tooling, I found myself reaching for three Asian skills. Uh two of them are related to design engineering. So one made it easier to have better UI, better typography, better layouts as well as like better error messages in general. And the second one was a set of design engineering skills that made it easier to just have better animations and other things like that. And then last but not least is the railway Asian skills, of course. So like everything that I built for us internally at railway runs on
11:27 railway of course like everything. So like buckets, databases, the app itself, the real-time server, everything. And for the agent to effectively work with railway and be able to deploy everything, you just give it the Asian skills and it was just able to do it. And yeah, so like once you have all of your Asian skills and everything, in my opinion, the final step and I think this the most important step is verification. So the agents typically whenever you ask it to build something, it’s going to be like, okay, I implemented the feature,
11:59 build passed, test pass, all good, right? But what I found is when you actually try out what happens, you sometimes end up with just like a very broken experience. So once you have like a verification loop in place, it’s like a night and day difference because the agent you can literally see it be like, “Okay, I built this thing. I tried it. It failed. I’m going to fix it.” And it just keeps going. And then in the end, it’s like, “Okay, I fully tested it.” And I felt this breakthrough with computer use once it got really, really
12:30 good. And now everything every time I want to add a new feature I literally just in the end say well you should verify that the feature works end to end and use it by actually running infrastructure and to test things end to end and the agents are very capable of doing this. You just have to tell them and once you have all those pieces I would say you will end up with solid internal tools that you can build quickly that work properly and work in a consistent way. And that’s it. This was
13:01 my list of principles that I use whenever I’m building any internal tools. Hope you found them useful, but more importantly, that you’re inspired to build your own internal tools that feel good, that are polished, and spark joy. And I hope that you too can become your company’s SAS layer. And with that, thank you so much for watching and I’ll see you in the next