From 20 hours to 3:
specs that write and update themselves.

I write the functional specs that development, QA and the Product team build on, and Training then carries them to the whole company. They took me 20 hours each and I had become the bottleneck. This is how I rebuilt the process, iteration after iteration, until specs started writing and updating themselves.

My role
Product Manager
Company
B2B SaaS for clinics
Process
5 stages, many iterations
Tools
AI, Figma, Meet, Drive
Spec...

Writing a spec used to take 20 hours. Now it takes 3, and it updates itself after every meeting.

01 Where it started

Every feature needs a functional spec before development. I write three to five a month, and each one took about 20 hours.

Developers, QA and the Product team all depend on that document, and through Training it reaches the whole company. While I was writing, they were waiting: the spec had become the bottleneck that set the pace of the roadmap. And by the time it was finished, the next meeting had already changed something.

I didn’t want to cut corners on quality. I wanted to stop spending my time on the parts that didn’t need me.

~20 hto write one spec by hand
outdatedas soon as a decision changed in a meeting
bottleneckdev, QA and Product waited on my spec

02 What I decided

I broke the 20 hours down to see where they went. Most of it wasn’t thinking about the product: it was drafting, copying screens from Figma and chasing decisions that had been made out loud in meetings. Each of those had its own fix.

Writing a spec took about 20 hours.

The AI drafts each section with its own expert agent: business goals, acceptance criteria and more.

Decisions were made in meetings and never reached the spec.

Meeting recordings of ideation and solution talks feed the spec, and follow-ups update it.

Screens and details were copied from Figma by hand.

Connected to Figma, the AI reads the design and pulls the screenshots itself.

03 How it went

I didn’t automate it in one go, and it took far more than five tries. I spent three weeks iterating only on the spec structure and the AI skill that writes it, spec after spec, until the output was something I’d sign. Then I automated one bottleneck at a time.

  1. 01A better manual specI refined the template, spec by spec.Still ~20 h by hand.
  2. 02One expert agent per sectionAI drafts each part: goals, acceptance criteria…Still a lot of manual glue.
  3. 03AI connected to FigmaThe AI reads the design and writes the functional analysis.Screenshots still by hand.
  4. 04Analysis that refines itselfIt polishes itself and pulls screenshots from Figma.Decisions still lived in meetings.
  5. 05Meetings in the loopMeet recordings feed the spec; follow-ups update it.Today's workflow.

Throughout: the AI creates the spec in Google Drive and keeps updating that same document.

04 Before and after

Before
Writing~20 h by hand
InputNotes and memory
ScreenshotsCopied one by one
UpdatesLate, if at all
Where it livesScattered versions
During developmentConstant questions
My timeWriting documents
Now
Writing~3 h reviewing and deciding
InputMeet recordings + Figma
ScreenshotsPulled from Figma
UpdatesRight after each meeting
Where it livesOne spec in Drive
During developmentFewer questions
My timeDiscovery and decisions

05 What changed

−85%spec writing time
~3 hper spec, down from ~20 h
liveupdated after every meeting
1source of truth in Drive
Fewer questions

Specs are more complete and up to date, so development asks less during the sprint.

Less rework

Decisions from meetings reach the spec, so fewer things get built differently from what was agreed.

More time for discovery

The hours I got back went into talking to clinics and deciding what to build next.

06 What I learned

Manual first. A great manual spec was the blueprint for the AI. If I hadn’t known what a good spec looked like, I couldn’t have taught it.

Iterate the process. I didn’t design the final system up front. Three weeks went into the structure and the AI skill alone, and each step removed the bottleneck the last one left.

Decisions stay human. AI removes the busywork, but the spec is only as good as the decisions behind it. My job moved from writing to deciding.

Interested?
Let's work together.

Product or design: if you have an idea worth building, I’d love to hear about it.

Follow my latest work on Ig,Be,In.
Drop me a line.

curve arrow of Gus Martinez Portfolio - Creative Graphic Designer and Illustrator