A friend of mine is a manager who coded their own startup idea with Claude. Since they're not a software engineer, the usual design documents and graphics (flowcharts, infrastructure diagrams) are missing.

I will try to find the golden thread and figure out how the application does things, and if these are the actual intended behaviours my friend wanted the application to fulfill.

However: what else can I do to get a hold of this mess? I thought about using Claude to generate MADRs and application diagrams, but then again, Claude probably talks shit. Any ideas on how to figure out how this application works apart from reading the source code and interviewing my friend about it?

all 5 comments

sorted by: hot top controversial new old
[–] 3 points 2 weeks ago* (1 child)

Claude is actually very good at analysing and documenting a codebase. Get it to do a high level analysis and document, and then more granular versions of that for sub sections, down to the level of detail where you think you need. Tell it to document just the functionality and business rules, rather than the code itself.

You can verify the details by hand and with your friend to be confident you've got the business rules correct. Then use Claude in a similar way to create technical design documentation from the business rules docs, starting at a high level design and then creating more detailed subsections. You can give it specific technical direction through this process, with the kinds of architecture and patterns you want to use.

If you haven't worked with Claude much, its important to know how to work with it for good results. Always break up your sessions with it. Just having a single conversation that you keep working on for days or weeks will give increasingly poor results as the amount of information it has to keep track of blows out. Have targetted discussions that generate an output (usually documentation) and then start a new conversation that uses the output from the previous discussion, but focuses on a more granular aspect of it. As you generate documents, have claude update its "claude.md" file, which is a project file with any info you want to include in every conversation. Having an index to your documents so it knows which document to look for for a specific subject will save you a lot of time and tokens.

This is whow I would reverse vibe code a vibe codebase. It sounds like you haven't used Claude much, it is actually very capable when managed correctly by a skilled programmer. I'm happy to answer any questions you have.

Cue the downvotes.

  • source
  • hideshow 2 child comments
  • [–] [S] 2 points 2 weeks ago (1 child)

    reverse vibe code

    Ha, that's a good description of what I'm doing.

    Thank you for your ideas!

    I have worked with Claude a bit in the past, but never vibe coded anything. I usually treated it as supercharged autocorrect/autocomplete.

    I'll try this and maybe report back with success 😊

  • source
  • parent
  • hideshow 2 child comments
  • [–] 2 points 2 weeks ago (1 child)

    You could use cline/zoo code or similar coding tools to generate project documentation. They will be faulty at some points but (at least in my case (using zoo code & qwen3.6) it works most of the time good enough. It will however take time and you'll still need to fact check any agent.

    Or you just trash it and start from scratch. With some restrictions, very detailed descriptions and tiny iterations these llms can generate usable code. But that requires knowledge of the systems your app/program will use.

  • source
  • hideshow 2 child comments
  • [–] [S] 1 point 2 weeks ago

    Thank you for the tool suggestions, appreciate it.

    I'm pretty sure this needs a total rewrite, but the software seems to have good functionality where you can get some design documents to start fresh.

  • source
  • parent