Ask HN: Do you write a technical doc first or just vibe code?

1 pointsposted 19 hours ago
by brihati

Item id: 46257562

6 Comments

delaminator

19 hours ago

I chat with Claude about viability, capability, existing solutions, alternative approaches, etc.

This helps me get an idea of what we’re doing. I get pushback and have to be clear and Opus is good at asking questions.

Then I get it to write a set of documents for Claude Code describing the vision, the solution, the technical choices, the testing plan, the validation approach, how to share with colleagues, future ideas and a table of contents.

brihati

6 hours ago

Great approach, since you are following a pre-defined set of approaches, have you thought of building an agent for it? or do you have a prompt which helps you with getting the relevant answer?

delaminator

5 hours ago

I have a projects folder in the app which has a set of instructions - bot mostly what documents to follow. It works well enough but you're right, I should push it a bit more.

It's great that we can iterate on the solutions and they become general.

rahmanyoo

19 hours ago

I tried both ways. Letting design emerge incrementally adds vibe-coded technical debt.

At minimum prepare project specs with features as .md file. I found claude to be useful for this task.

If you’re using Cursor, pick a template from here. https://cursor.directory/rules

brihati

6 hours ago

I agree. have you tried any framework such as spec-kit by Microsoft to generate feature specs?

rahmanyoo

an hour ago

i have not. Just a personal preference to write specs myself because i want as much control at early planning stages.