Ask HN: Why spec-driven development when code IS spec?

2 pointskikkupico26d ago7 comments

Code, as such, is a detailed, verifiable spec that a machine can execute. LLMs are already great at translating code to natural language and vice-versa. Why do we need a second, less detailed and less verifiable copy of the code?

7 comments

re-thc26d ago

> Why do we need a second, less detailed and less verifiable copy of the code

Because it requires people to know how to read or specify code.

Spec driven development is similar to the no-code movement i.e. the specs are closer to functional requirements than this strict spec or code.

You can argue that you can just ask the LLM to explain back and forth but it can still be too much.

kikkupicoOP26d ago

> You can argue that you can just ask the LLM to explain back and forth but it can still be too much.

But then you'd get an explanation tailored to your specific perspective instead of a generic one, right?

re-thc26d ago

> But then you'd get an explanation tailored to your specific perspective

Assuming you know how to ask the right questions and make sense of it. Tailored to whose perspective, especially in a team, which then might make it worse.

cclacerda1326d ago

The answer is exactly on you question. Code is detailed. It need to has every implementation detail, a spec is high level view demoted of all unnecessary details!

kikkupicoOP26d ago

What do we gain by maintaining a high level view instead of asking an LLM to explain the code at a high level when required?

cclacerda1325d ago

It captures the why and what of the system from a business or user perspective. Existing code don't inherently capture the original business problem or design choices that led to that code.

1 more reply

j / k navigate · click thread line to collapse

7 comments

re-thc26d ago

> Why do we need a second, less detailed and less verifiable copy of the code

Because it requires people to know how to read or specify code.

Spec driven development is similar to the no-code movement i.e. the specs are closer to functional requirements than this strict spec or code.

You can argue that you can just ask the LLM to explain back and forth but it can still be too much.

kikkupicoOP26d ago

> You can argue that you can just ask the LLM to explain back and forth but it can still be too much.

But then you'd get an explanation tailored to your specific perspective instead of a generic one, right?

re-thc26d ago

> But then you'd get an explanation tailored to your specific perspective

Assuming you know how to ask the right questions and make sense of it. Tailored to whose perspective, especially in a team, which then might make it worse.

cclacerda1326d ago

The answer is exactly on you question. Code is detailed. It need to has every implementation detail, a spec is high level view demoted of all unnecessary details!

kikkupicoOP26d ago

What do we gain by maintaining a high level view instead of asking an LLM to explain the code at a high level when required?

cclacerda1325d ago

It captures the why and what of the system from a business or user perspective. Existing code don't inherently capture the original business problem or design choices that led to that code.

1 more reply

j / k navigate · click thread line to collapse