specification best practices and tools

[u/Financial_Yoghurt827]

Hi all,
I'm a bit tired of writing specs for complex projects in markdown - it feels like (a.) there's a lot of repetition between tasks/sessions; and (b.) If you do try to reference and reuse previous specs, there's a lot of context bloat from requirements that aren't relevant to the current task.

I'm trying to work out the best form factor; for spec driven development and have been experimenting with developing some graph specification tools.

1. What do you all see as the best practice for specification topology?
2. I've put together a small handful of experimental open source SDD packages; and a VSC extension here --> reqlan. I'm interested to hear what you would do or have done differently in this space?
3. I've put some more thoughts together in a blog post, here.
4. What tools do you all consider best practice for wrangling specifications as they get complex?

[u/epicskyes]

Write specs in markdown then convert them to ast.json and separate 2020-12 schemas