Comment

Comment by hackermailman

Try this book https://essenceofsoftware.com/

For example your personal website has a concept with no purpose the upper right oval things which are PgUp/Dn on my phone display. If you learn basic conceptual design you can easily architect small sites like the things in your portfolio while sitting in front of someone, then have AI of choice immediately build the entire user interface and they can test it out themselves.

Translating concepts into typescript code is trivial and exampled here https://61040-fa23.github.io/pages/concept-implementations.h... and AI can do this for you. The idea is concepts are reusable and modular and self contained. Whatever the user sees or has functional access to is what you design for and AI generates the hidden backend. If you design this way you discover many things are identical and can reuse an existing concept for it. You also discover many things have no real purpose and should be removed such as the 'don't hire me' section.

Some of the problems with your personal biz advertising site others have mentioned would've been caught by conceptual design such as what is the purpose of this site? To display a portfolio of work and harvest leads. What is the operational principal or how would someone use this site? Then you'd immediately catch there's no about me description above the logos/names etc., no obvious contact page therefore no harvesting of leads. You'd see that the descriptions of each portfolio entry should be included when you click on them instead of having these at the bottom of the page under 'Notable'. What is the purpose of enlarging an entry? To get more information. That is 2 concepts with the same purpose and break the design. Why not just include the notable designs and leave out the rest?

Anyway that book changed the way I write software and it fits nicely with vibecoding up a prototype.

Discussion

Live from the official Hacker News API

A modern reader for Hacker News · SvelteKit + Skeleton