All posts

Eight months, no plan, nothing shipped. We shipped it in two.

Published July 28, 2026 · by Majd Ghithan, written with the help of AI

Eight months, no plan, nothing shipped. We shipped it in two.

A team had been building a health platform for eight, maybe nine months. The client had run out of money. And there was nothing to ship — not because the code didn't exist, but because nobody in the building could tell you what "done" meant.

That's the part people miss about stuck projects. They're rarely stuck on a hard technical problem. They're stuck because the thing being built was never actually described.

What we walked into

I've inherited messy codebases before. This was a different kind of mess — the kind where the code is the least of your problems:

  • No written plan. Not a light one. None.
  • No business requirements. Nobody could say what the product had to do, only what had been half-built so far.
  • No scope — and, worse, no sense of what was out of scope. Every idea was still theoretically in.
  • No design source of truth. No Figma, no UX reference. Screens were invented at the keyboard.
  • No QA. No automated tests. "It worked on the last device we tried" was the entire quality process.
  • No database migrations, no backups. The schema lived wherever it had last been hand-edited.
  • A dev team that couldn't tell you what the app needed next. Not from lack of skill — from lack of a map.

On paper it was "feature-complete." In reality it was unshippable, and every week of unfocused effort was burning a budget that was already gone.

Time to a shippable product
92Previous 8–9 monthsUs
months

The unglamorous fix: we stopped coding and started writing

The instinct on a late project is to code faster. That's how you get to month nine. We did the opposite — for the first stretch, we barely wrote code at all. We wrote sentences.

We wrote the business requirements. We defined the scope, and we defined the far more valuable thing: what we were not building. We wrote down what "done" meant for every single screen — the states, the errors, the edge cases — so "done" stopped being an opinion and became a checkbox.

A vague ambition that had lived in five people's heads for eight months became one list you could actually finish.

Then we built it properly

With a plan in hand, the engineering went fast — and we built it the way a health platform actually has to exist, not the way a demo does:

What we inherited
- No plan / no requirements
- No design source of truth
- No QA, no automated tests
- No migrations, no backups
- Hand-edited schema
- Unhardened, demo-grade build
- English-only, hardcoded strings
What we shipped
- Written scope + definition of done
- Real design + UX
- Test suite + QA gate
- Migrations + automated backups
- Reproducible schema
- Production-hardened release
- End-to-end EN/AR + RTL

We put in the scaffolding that makes a product safe to actually run: proper database migrations and automated backups, a real test and QA pass before release, hardened builds and store-grade release signing, server-verified payments, crash reporting, and real end-to-end localization (English + Arabic, RTL) instead of hardcoded strings. Reliable voice and video consultations too — the enterprise-grade version of every corner that had been cut.

The result

Two months after we started, it was live.

Real patients, real consultations, real payments — the platform that "couldn't be finished" in nine months, finished and shipped in two.

If your project has been almost done for months, be honest about what's missing. It's usually not one more sprint. It's a document — the boring one that says, in plain words, what you're actually building and how you'll know when it's done.

🤖 Heads up: this post was drafted with AI. Spot something wrong or off?Edit it on GitHub & open a PR
Majd Ghithan

Majd Ghithan

Full-Stack Engineer & Tech Lead

More posts

GEO vs SEO: getting found when nobody googles anymore

GEO vs SEO: getting found when nobody googles anymore

Think about the last time you needed to know something technical. Did you open Google, scan ten blue links, and click through? Or did you just ask ChatGPT or Claude and read the…

July 28, 2026Read more
Laravel finally resizes images for you

Laravel finally resizes images for you

Every Laravel app I've built that takes an avatar ended the same way: composer require intervention/image, wire up a facade, write a little service class, and hope the next dev…

July 26, 2026Read more
What actually breaks at 100,000 users (that never breaks in a demo)

What actually breaks at 100,000 users (that never breaks in a demo)

The first time I shipped a dashboard to a hundred thousand active users, nothing I had tested was what broke. Everything that failed had passed every check I ran. It worked on m…

July 25, 2026Read more
Where your queue jobs go to die under load

Where your queue jobs go to die under load

The support ticket said "I never got my invoice email." I checked the logs. The job ran. It succeeded. failedjobs was empty. Everything said the email went out. It did not.

July 18, 2026Read more
The indexes you're missing (and the one that's hurting you)

The indexes you're missing (and the one that's hurting you)

A client sent me a query that took 4.2 seconds. One WHERE, one ORDER BY, a table with three million rows. I added a single index and it dropped to 11 milliseconds. They asked if…

July 11, 2026Read more
Caching in Laravel without the stampede

Caching in Laravel without the stampede

We cached the homepage's "trending products" query for five minutes. It was our slowest query — about 900ms, a big aggregation across orders. Caching it took the homepage from s…

July 4, 2026Read more
Taking one endpoint from 800ms to 80ms

Taking one endpoint from 800ms to 80ms

The order-details endpoint took 800 milliseconds. Not broken, just slow enough that the app felt heavy everywhere it was used. The team's instinct was "the server needs more mem…

June 27, 2026Read more
The N+1 you can't see (it's hiding in your accessors)

The N+1 you can't see (it's hiding in your accessors)

I've fixed hundreds of N+1 queries. The easy ones are right there in the controller — a foreach with $order-customer inside it, obvious the moment you read the code. Those aren'…

June 20, 2026Read more
The Friday deploy that charged customers twice

The Friday deploy that charged customers twice

It was 4:40 on a Friday. The change was tiny — a one-line tweak to how we called the payment provider, plus a bump to the queue worker's timeout. Small, tested, reviewed. I depl…

June 13, 2026Read more
Code review people don't dread

Code review people don't dread

I once left forty-one comments on a junior's pull request. I was proud of it. Thorough, I told myself. The next day he barely made eye contact, and his next PR sat open for a we…

June 6, 2026Read more
Hiring a mid-level Laravel dev: the signals that actually matter

Hiring a mid-level Laravel dev: the signals that actually matter

The best hire I ever made failed my first question. I asked him to explain service containers and he stumbled, went quiet, then said "honestly I use them every day but I've neve…

May 30, 2026Read more
Saying no to a feature without being the 'no' person

Saying no to a feature without being the 'no' person

For about a year I was the engineer everyone learned to route around. Not because I was wrong, I was usually right, but because my answer to new ideas was a flat "no, that'll br…

May 23, 2026Read more
My first 90 days as a tech lead (and the habit I had to break)

My first 90 days as a tech lead (and the habit I had to break)

Three weeks into leading my first team, I stayed late to "help" by rewriting a junior's feature myself. It was faster my way. I pushed it, felt productive, went home. The next m…

May 16, 2026Read more
Breaking down the task that scares you

Breaking down the task that scares you

There's a specific kind of ticket that makes my stomach drop. Not the hard ones, hard is fine. It's the ambiguous ones. "Migrate billing to the new provider." "Add multi-tenancy…

May 9, 2026Read more
1:1s that aren't just status updates

1:1s that aren't just status updates

For my first few months as a lead, my 1:1s were thirty minutes of me asking "so, what are you working on?" and nodding at answers I already knew from standup. We both left sligh…

May 2, 2026Read more
Get the business logic out of your controllers

Get the business logic out of your controllers

I once opened a OrderController@store method that was 240 lines long. Validation, a discount calculation, three model writes, a Stripe charge, two emails, a Slack notification,…

April 25, 2026Read more
Form Requests are the most underrated thing in Laravel

Form Requests are the most underrated thing in Laravel

Most Laravel devs meet Form Requests once, in a tutorial, use them to hold a rules() array, and never look deeper. That's a shame, because a Form Request is the cleanest place i…

April 18, 2026Read more
Testing Laravel without mocking everything

Testing Laravel without mocking everything

I inherited a codebase once with 900 unit tests and no confidence. Every test mocked the repository, mocked the model, mocked the mailer, mocked the thing three layers down. The…

April 11, 2026Read more
Three Eloquent features that clean up your models

Three Eloquent features that clean up your models

The messiest Laravel model I ever wrote wasn't messy because of Eloquent. It was messy because I ignored the parts of Eloquent that exist specifically to keep it clean. The same…

April 4, 2026Read more
The migration that locked the table for eight minutes

The migration that locked the table for eight minutes

The deploy looked boring. One migration, adding a lastseenat column to the users table with a default of now(). I'd written a hundred like it. I ran it at 2pm on a Tuesday becau…

March 28, 2026Read more
Chasing a memory leak in a Laravel queue worker

Chasing a memory leak in a Laravel queue worker

The alert came in at 4am: one of our queue:work processes had been OOM-killed. The supervisor restarted it, it processed jobs for about forty minutes, and got killed again. It w…

March 21, 2026Read more