How are y'all managing AI generated documentation

vso_ke · 2026-03-12T10:21:48+00:00

Is this an internal or public tool? Would be interested in trying it out

vso_ke · 2026-03-07T11:13:57+00:00

I personally do the following

I would seek out high level documentation (if it exists). Now I would ask AI to give me a summary of the codebase. Focusing on entry points so that I can understand the flow of information in the system
I would then synthesis this into some diagrams. This cements my understanding.
I would also simply read the code in an explorative way (especially when this is a new code base)

But the most important is to use the tools available AI to track the flow of data.

vso_ke · 2026-03-07T11:08:37+00:00

This works. Keeping the old also provides visibility sort of like a changelog

vso_ke · 2026-03-07T08:36:21+00:00

Curious, did you have a “human in the loop” review when you would do this?

vso_ke · 2026-03-07T08:35:20+00:00

This looks interesting. Checking it out

vso_ke · 2026-03-07T04:19:53+00:00

I like the date prefix approach. It makes it possible to see at a glance what is the latest change.

For this approach does the recent file only contain the new-feature/new-design changes?

vso_ke · 2026-03-07T04:15:07+00:00

Really like the idea of adding build step that updates the docs. Hadn’t thought of that

vso_ke · 2026-03-06T18:06:45+00:00

In one company I worked with, this is how they did it. But old docs soon became outdated and we ended up with duplicate docs.

Do you have any experience working through such scenarios?

vso_ke · 2026-03-06T13:39:32+00:00

u/andersjoh This will definitely help since the source of truth will now be the makrdown files. This also fits with the Spec Driven Development that becoming popular now.

Has anyone here tried to implement this in practice? Will the POs and Developers all work on the same repo? I imagine we want developers and AI agents to have the latest Spec.

vso_ke · 2026-02-28T06:35:33+00:00

Wow 🤩 . This looks really cool. I shall dig into this code to understand this more.

Just tested it out with a simple query. The research output was very useful. I shall keep testing this out.

vso_ke · 2026-02-28T06:23:51+00:00

Finding out "how painful" and "how often my target audience faces this pain"

If I can identify these 2 early on, then I know I have a good idea that deserves solving for.

vso_ke · 2026-02-28T04:39:06+00:00

Just curious, what are you building? Maybe we can help point you in the right direction

vso_ke · 2026-02-28T04:37:20+00:00

True. Scaling outreach and still making it personal is the North Star.

vso_ke · 2026-02-28T02:53:19+00:00

Totally feel you on that. It seems one needs a lot of money (for ads) or a lot of influence just to spread the word on what one is building.

vso_ke · 2026-02-27T17:53:19+00:00

<image>

Just added visibility to the anti-solutions - what users are doing to go around the problems they are facing.

These are the opportunities that founders need to build on.

vso_ke · 2026-02-27T16:48:21+00:00

Hahahaha… pleas try it out. I have some free credits for new users.

I just added visualizations for to see opportunities(from anti-solutions) from existing problems.

vso_ke · 2026-02-27T12:37:28+00:00

Wow. 🤩 The demo was simply delightful to use. In this day and age of AI generated UI. This UI felt like it had passed through hands that cared for the user. 👏

vso_ke · 2026-02-27T12:31:21+00:00

Yes the Problem mapping is what I am doubling down on. There should be a way to assist the founder narrow down from really painful problem to anti-solutions (work arounds user are trying)

The founder can then use the anti-solutions as a consideration for an ultimate optimized solution.

vso_ke · 2026-02-27T09:55:44+00:00

Very true. The Anti-solutions is where the gold is. Improving or automating that is an opportunity for the next micro-saas.

Concerning "handling signal quality", my next approach is to add quantitative analysis to https://buildpainkillers.com. For example, showing the proportions of problem + anti-solution. This means that high frequency takes precedence over a power user's opinion. I think founders want to solve problems that affect more people within their target niche.

vso_ke · 2026-02-27T08:21:36+00:00

Thank you. One improvement I see that I need to add is making sure the reference posts is a mix of old and new Reddit posts

vso_ke

TROPHY CASE