Articles/Vision
Your product moved. Your content didn't.
A product company's content is about its product, and the product is the code: always changing, true at every moment, and silent about what it means. What the code does, projected onto the problems each role has, is what marketing, support and sales run on. Keep it true, in both directions, with agents.
Juan J. Perez · Sharely.ai·November 5, 2026·8 min read
In short
- If you make a product, your content is about the product, and the product is the code. You may not want to share the code, and even if you do, nobody updates a help center from a diff. Everyone depends on what the code does: the capabilities, projected onto the problems each role has.
- Every release moves that truth. Marketing, support and sales content stays where it was, and the people who used to carry the difference by hand cannot keep up with a product that agents now build.
- So agents carry it. Today, from the code to the content: reading each change, saying what it means in product terms, and finding where the content no longer agrees. Next, from engagement with the content back to the backlog. It is a loop, and the faster it turns the truer everything stays.
- And it is not only about catching up. With the product truth, the content and the problems in one place, agents can search the combinations of capabilities that solve a problem in a way nobody else can, draft the page, and let engagement tell you within days whether it mattered.
If you want to know what your product does today, not what the roadmap says and not what the deck says, there has only ever been one way to find out. Engineers even had an acronym for it: RTFC. Read the code. Which is exactly why marketing, support and sales have always been a release or two behind. They were never going to read the code. Now they don't have to. Agents read the code, and they read it every time it changes. Everything in this article follows from that.
Your content is about your product
Every organization serves people through content. For a product company, nearly all of it is about one thing: the product, the community that forms around it, and the movement the product makes possible. The help center explains it. The sales deck promises it. The onboarding guide teaches it. The community forum argues about it.
And the product is not a fixed thing. It is alive. It changes every week, sometimes every day, and now that agents write a growing share of the code, it changes faster than any team of people has ever had to describe.
In the last article, I argued that knowledge is the new code: that what each role sees and what agents may do for them is decided by knowledge, so knowledge needs the rigor we give code. This one is about the product company specifically, where the relationship runs the other way too. The knowledge is about the code.
The truth is in the code
Ask what your product does right now, today, and there is exactly one honest answer: whatever the code does. Not the roadmap, not the brochure, not what the sales engineer remembers from the last demo. At any moment, the truth of the product is in the code.
You may not want to share the code. Most companies don't. But even if you do, and plenty do, sharing the code solves nothing here, because code does not push anything to anyone. A merge changes what the product does. It does not update the brochure, the help center, the sales deck, or the answer a support agent will give tomorrow. Open or closed, the code sits there, true and silent.
What people actually run on is what the code does: the capabilities it gives them, the user stories it fulfills, the value it delivers. That is a projection of the code, and it is the part the whole organization depends on. Marketing projects it onto buyers. Support projects it onto customers with a problem. Sales projects it onto a prospect's situation.
A capability on its own means nothing. It only means something against a problem someone has. That is why the natural carrier of the projection is an agent for each role: something that knows what the product can do and meets a person inside the problem they actually have.
The truth
Your code
Open or closed, it changes with every merge. True at this moment and only this moment.
Shared or not, nobody updates a help center from a diff. People need the projection.
The projection
What it does
The part you do share. Capabilities and the user stories behind them.
Role-based access
Each person sees what their role may see.
Approval workflows
Changes wait for the right sign-off.
Works offline
Procedures load when the signal does not.
Every language
One source, translated for each region.
The problems
What each role is trying to do
A capability only means something against a problem. An agent per role carries the projection there.
Support rep
Support rep agent
A customer asks whether approvals work on the mobile app.
Draws on: Approval workflows · Works offline
Sales engineer
Sales engineer agent
A prospect wants to know what shipped since their last demo.
Draws on: Role-based access · Every language
Customer admin
Customer admin agent
Needs to roll the product out to a new region next month.
Draws on: Every language · Role-based access
Every release moves the truth
Here is the problem. The code moves and the content does not. A release ships approvals on mobile, and the help center still says approvals are desktop only. A pricing page describes last quarter's tiers. A support agent, human or otherwise, answers from a procedure that no longer matches the screen.
Nothing errors. Nothing warns. The content is simply less true than it was yesterday, and it gets a little less true with every merge. That is drift, and in a product company it is the default state of all content that is not actively being pulled back toward the code.
Until now, people carried that burden. A product manager wrote the release notes. A content manager updated the pages they remembered to update. A support lead noticed the same question five times and filed a ticket. It worked, roughly, when a product changed a few times a month. It does not work when agents are shipping to the code every day.
If agents are building the product, agents have to find the drift between the product and everything that describes it.
It runs both ways
The code informs the content. That part is obvious once you see it. The less obvious part is that the content informs the code.
Every question a customer asks the support agent, every search that returns nothing useful, every conversation where a prospect asks for something the product does not do yet: that is engagement with the knowledge, and it is the best product signal you have. It is already in your organization's own words. It just never reaches the backlog, because the people who could carry it there are busy.
So the loop looks like this. The code becomes capabilities. The capabilities become content. People engage with the content, and where they ask, search and miss becomes the backlog. The backlog becomes code. Every product company already lives inside this loop. The question is how fast it turns, and who carries each hop.
1
Your code
The truth at any moment. Changing with every merge, and silent about what it means.
- GitHub
2
What it does
The part you do share: the capabilities, the user stories, each release.
- Capabilities
- User stories
- Releases
3
Content and knowledge
Marketing, support and sales all run on it. It is only right while it matches the code.
- Drupal
- WordPress
- Google Drive
- OneDrive
- Your website
4
Engagement
How people actually use the knowledge, and where it fails them. The best signal you have.
- Questions asked
- Searches
- Answers that missed
5
Backlog
What to build next, fed by what people asked for and could not find.
- Jira
- Asana
Every hop in that loop used to be a person's job. The point is not to remove the people. It is to let agents carry the hops so that people can review what the agents propose: a page that no longer matches the release, a ticket drafted from fifty variations of the same question, a note that the roadmap item customers keep asking about is three sprints out.
What one change looks like today
This is what we are building into Sharely, and most of the top of the loop is already running. It builds on what was there: the governed core that holds what each role may see, in each language, with its structure intact, and the sync from where content lives. Sharely for Drupal and Sharely for WordPress. Google Drive and OneDrive. Your website, which Sharely re-crawls and notices when a page changes or disappears.
The new part is the truth side. Sharely for GitHub connects as a read-only app. It reads each push, pull request, release and tag through GitHub's API and keeps no copy of your code. The first connection creates a role in your workspace, and we named it what it is: Product truth.
For every change, an agent reads the diff and writes down what it means in product terms: which capabilities it touches, which surfaces, and which gates stand in front of it, the plan, the flag, the permission. That is the projection from the previous section, made by a machine, from the code, every time the code moves. Then it checks that projection against every page it touches.
A change arrives
PR #482 merged
Approvals on the mobile app. Tagged into v2.14.
Read through GitHub's API. The code is never copied.
What it means
The projection, in product terms
Capabilities
- Approval workflows
- Mobile
Surfaces touched
- iOS app
- Admin
Gates
- plan ≥ growth
- flag approvals_mobile
Matched to its Jira story. Planned and shipped compared; any difference is recorded.
Findings
Every page this change touches
Help center · Approvals
contradictedblockerSays approvals are desktop only. Proposed edit cites approve.ts:41–58 @ 9f2c1a.
Onboarding guide · Week one
staleshould fixScreenshots and steps predate the mobile flow.
Pricing · Plans
consistentinfoAlready lists approvals under Growth and above.
Release notes · v2.14
gapshould fixNo related content. Nearest page suggested, draft paragraph attached.
Review
Accept, edit, or dismiss
- Accept and assign
- Edit the proposal
- Mark consistent
- Dismissinternal · not yet · intentionally undocumented
Grouped by release: before you announce v2.14, here is what has to change. Blockers go to Slack.
Each related page gets a finding: contradicted, stale, incomplete, or consistent, with the excerpt, a proposed edit, and a citation back to the lines of code that make it so. Where nothing related exists at all, that is a gap, and it comes with the nearest page and a draft paragraph. A person reviews each one: accept and assign it, edit it, or dismiss it as internal, not yet, or intentionally undocumented. Grouped by release, it answers the question every product marketer has before a launch: what has to change on the site before we announce this?
Jira and Asana connected this week. They bring the intent: the story behind the change. When a Jira issue reaches done or an Asana task completes, the agent compares what was planned with what the code actually did, and records where the two differ. That is the backlog talking to the code, and it is the first half of the bottom of the loop.
The second half is next. Searches that found nothing. Questions the agent could not answer. The same request asked fifty different ways. Sharely already measures all of it. Carrying it into the backlog, drafted for a person to accept, is where the agents go from here, and it is what closes the loop.
The truth is in the code. Pull everything else toward it, and pull the backlog toward the people.
Not only reacting. Composing.
Everything so far is about catching up. The code moved, so the content has to move. That alone is worth a great deal. But once you hold the three things together, the product truth as a vocabulary of capabilities, the content, and the problems people bring, something else becomes possible. You can get ahead of the code.
Most solutions are not one capability. They are a combination. Works offline, plus approval workflows, plus role-based access is not three features. It is a field technician getting a change signed off from a basement with no signal, which is a solution, and possibly one nobody else can offer. The interesting content lives in those combinations, and they are exactly what a team never has time to find. There are too many of them, and the ones worth writing about are rarely obvious from inside the product.
Agents can search that space. With the vocabulary in hand, they can enumerate the combinations, ask which ones solve a real problem for a real role, check which ones no competitor can match, and draft the page. A person accepts the proposal and publishes it. Then the loop does its work faster than it ever could. Within days you know, from search, from who lands on the page, and from what people and agents ask next, whether that combination mattered.
The vocabulary
Every capability, from the code
Built change by change. Eight here; a real product has hundreds.
- Role-based access
- Approval workflows
- Works offline
- Every language
- Audit trail
- Scheduled publishing
- Field forms
- Notifications
Eight capabilities make 56 pairs and 56 triples. Hundreds make millions. Nobody searches that by hand.
Combinations worth a page
A solution is three capabilities and a problem
Field approvals without a signal
Works offline + Approval workflows + Role-based access
Field technician. Needs a change signed off from a basement with no coverage.
Novel · no competitor does this
A regional rollout in one week
Every language + Role-based access + Scheduled publishing
Customer admin. Has to bring a new region live without a second content team.
Differentiated
Audit-ready volunteer onboarding
Audit trail + Field forms + Notifications
Volunteer lead. Must show who completed what, and when, for every volunteer.
Table stakes · skip
Rated against the problem and against competitors. The agent drafts the page for the ones worth it; a person accepts it.
The world answers back
Within days, not quarters
- Day 1A person accepts the draft. Published.
- Day 3Searches start landing on it.
- Day 5The role agent gets asked about it.
- Day 10A prospect brings it up in a demo.
- NextThe questions it raised reach the backlog.
- Search
- Landings
- Engagement
- Agent questions
All of it measured today. Whether the combination mattered is no longer a guess.
This is the part that feels like an explosion the first time you see it run. The product truth, the content, the problems, the backlog, and agents on every hop do not just keep the content true. Together they generate it, test it against the world, and feed what they learn back into what gets built next.
Agents keep the content true. Then they get to make it interesting.
Building a product?
Tell us where your truth lives and where your content lives. Or pick a time and walk us through it.
Schedule time with us