What I Learned the Hard Way Building ParrotBot™
- John Gallagher

- Mar 3
- 3 min read
I’ll admit something.
Recently, I spent about five hours building an AI agent for closet companies. In my head, this was going to be simple:
Upload the spreadsheet.
Turn on the AI.
Ask a question.
Receive brilliance.
Cue angelic choir.
Instead, what I got was… thinking.
Lots of thinking.
Forty-eight seconds of thinking.
Which, in AI time, feels like watching someone dial-up the internet.
The AI wasn’t broken.
My document was.
And that was the breakthrough.
The Myth: “AI Can Read Anything”
We’ve all been told that AI can “read documents.” And that’s true — technically.
But there’s a massive difference between:
A human-friendly document
and
A machine-structured knowledge base
Most closet company documents were designed for humans. They rely on:
Visual grids
Merged cells
Color coding
Grouped headers
Blank spacer columns
“Implied” relationships
A designer looks at a door chart and instantly knows:
“Oh, that finish works with Classic II but not Modern.”
The AI looks at the same sheet and thinks:
“Why is this column empty? Why are there merged cells? Why is green good? Why is this row floating?”
It doesn’t see logic.
It sees formatting gymnastics.
And it has to reverse-engineer the intent.
That’s not instant. And it’s not reliable.
The Translation Layer Nobody Talks About
There’s a hidden step in AI implementation that most people skip.
It’s the translation from:
Human visual layout
to
Machine-readable structure
That translation process goes by a few names:
Data normalization
Schema design
Canonical structuring
Knowledge modeling
It sounds technical. But it’s actually simple:
Instead of a wide compatibility grid with checkmarks, you convert each compatibility into its own row. One row equals one explicit truth. No formatting required. No implied logic. No interpretation needed.
When you do that, AI becomes fast. Accurate. Confident.
Like a designer who’s had coffee.
Why This Matters for Closet Companies
Board and door matrices are a perfect example.
They are:
High volume
Frequently updated
Used by every department
Expensive to get wrong
When they live as visual grids, they work beautifully for humans.
When they are normalized into structured rows, they work beautifully for AI.
And once they work for AI, you get:
Faster product recall
Fewer engineering clarification emails
Fewer spec errors
Reduced production delays
Fewer “Wait… that’s discontinued?!” moments
That’s not just convenience.
That’s ROI.
And we like ROI around here.
What About SOPs?
This same translation principle applies to SOPs.
Many SOPs are written as long paragraphs, email threads, or loosely formatted documents that rely on context and human interpretation. That works when someone reads the entire thing carefully. But AI performs best when information is clearly structured.
This is where Markdown becomes powerful.
Markdown is a lightweight formatting system that uses simple symbols to create hierarchy and structure. Instead of writing a dense block of instructions, you use clear headings, subheadings, and bullet points to separate steps and define sections. For example, instead of burying payment collection steps inside a paragraph, you would clearly label sections like “Before Installation” and “At Completion,” and list the required actions beneath each.
Why does this matter?
Because structure reduces ambiguity.
Clear headings tell the AI what category information belongs to. Bullet points signal distinct steps. Defined sections prevent unrelated ideas from blending together.
It turns “a paragraph someone wrote at 10:47 p.m.” into a system.
The Real Lesson
When I first started building ParrotBot™, I assumed the AI would “just figure it out.”
And to be fair — it can figure it out.
But it works best when we meet it halfway.
The breakthrough wasn’t better prompts.
It was better structure.
AI is not magic dust you sprinkle on messy files.
It’s a multiplier of clarity.
If the structure is clear, AI becomes powerful.
If the structure is fuzzy, AI becomes… philosophical.
A Forward-Thinking Tip for Leaders
As you write new documents moving forward, ask:
Is this formatted for human scanning only?
Or is it structured so an AI can parse it cleanly?
Does each row represent a single truth?
Are relationships explicit instead of implied?
Are headings and sections clearly defined?
We are entering an era where every document is potentially dual-purpose:
Human-readable
and
AI-readable
The companies that adapt to that reality early will move faster.
Not because they have “better AI.”
But because they have better structure.
Moral of the Story
AI isn’t here to replace your expertise.
It’s here to amplify it.
But it needs clean inputs.
We’re all still learning this new relationship with AI. That’s not ignorance — that’s leadership in real time.
And once you understand the translation layer, you’re no longer “trying AI.”
You’re designing systems that scale.
And that’s where the real leverage begins.




Comments