SDD Flow — purpose and motivation
I’m working on SDD Flow as an operational complement to SDD (see the project repository: applica-software-guru/sdd on GitHub). The basic idea is simple: if the Story is the single source of truth, we need a repeatable, traceable flow that turns Story changes into technical artifacts (tests, specs, code) while keeping human intent central.
Why SDD Flow
In experiments with agent-assisted development I observed two recurring problems:
- Agent outputs are often non-deterministic: the same prompt can produce different results;
- Implementation decisions disperse across branches, prompts, and commits, breaking the link to original intent.
SDD Flow was born to address those problems: it coordinates the steps (extract Story, generate proposal, run automated checks, human review, commit), records context, and makes the whole process reproducible.
What it does, in practice
- Orchestration: defines a pipeline of steps that turn the Story into verifiable outputs (for example, tests, API descriptions, or code snippets).
- Audit trail: every mutation is linked to the Story fragment that produced it, so you can reconstruct why a change happened.
- Human control: places a review gate where I accept, edit, or discard the proposal before the final commit.
- Integrations: designed to work with different assistants/agents and the SDD Flow repository (see applica-software-guru/sdd-flow on GitHub), and with the project homepage: sdd.applica.guru
Origin of the project
SDD Flow originated while I was working, together with a colleague, on the SDD project: we wanted a practical way to apply the Story-Driven philosophy to daily development work without losing traceability or introducing non-reproducible steps.
Who it helps
It helps anyone who wants to experiment with development agents without losing human control and decision history: solo developers, teams augmenting their workflow with assistants, and anyone who prefers processes where intent remains discoverable.
Where to find the code and details
The source code for SDD Flow is available in its own repository: applica-software-guru/sdd-flow on GitHub. For public-facing info and documentation visit the project page: sdd.applica.guru
Try it and give feedback
I invite you to explore the project and give input. The code is open and free to use — you can run SDD Flow on your own machines or infrastructure and evaluate how it fits your workflow. Visit the repository (applica-software-guru/sdd on GitHub) or the project homepage (sdd.applica.guru) to get started.
If you have suggestions, bug reports, or ideas for improvement, please open an issue or start a discussion in the repository — feedback is very welcome and helps shape the project.