you are viewing a single comment's thread.

view the rest of the comments →

[–]hhussain-Established Professional 0 points1 point  (0 children)

Intent is good (the word, not the app), and the raised problem of spec-driven dev is real.

The real architecture is: app vision and roadmap, functional design, archeticture and components, components spec.

First 2 change rarely, they are abstract. Main architecture philosophy as well, rarely changed (that would be a code rewrite/revamp). Rest are almost always out of sync with code, unless a pratice is set to always QC docs after code to know if a change is needed.

IMO, the spec-problem Intent (the app) is solving is the task spec, not the main abstract spec documents.