Kiro: A new agentic IDE

> 2. Technical design based on requirements > Kiro then generates a design document by analyzing your codebase and approved spec requirements. It creates data flow diagrams, TypeScript interfaces, database schemas, and API endpoints—like the Review interfaces for our review system. This eliminates the lengthy back-and-forth on requirements clarity that typically slows development.

This is nice for documentation but really having a design document after-the-fact doesn't really help much. Designing is a decision-making process before the code is written.

The Eisenhower quote comes to mind: "Plans are worthless, but planning is everything."

I read it as after requirements and before code. This is how I would expect it to work too. It reads the existing codebase, which also makes sense for non greenfield projects as in the example.

If you don't start with approximately the right destination, you're definitely never going to end up there, even if you have to take some detours and compromise on some choices.

It gets really frustrating reviewing people's designs at times, when it's crystal clear they're a) working backwards and b) haven't really considered the customer experience at all.

One of my favourite tell tale signs of a) is when the chosen option 100% fits the specifications, doubly so if there's no cons associated with the pros. Sometimes it's genuine, but very rarely.

I slightly disagree. Plans are really useful for enhancements. If we stick to original plans & patterns as we extend & add new features, we can slow down the decay process.

Kiro takes the requirements and the existing code to create a spec.

Otherwise the spec may cover requirements that are already met in the existing code and needs to understand integration points it needs to include in the spec.

Having used Kiro myself I think it does what you expect.