Define the behavior.
Describe what should happen, the boundaries that matter, and what a good result looks like.
A clear specificationA clear line from what you asked for to what you can verify. SDDFW connects requirements, checks, and evidence for your next AI-built change.
CHANGE / RESERVATIONS
Allow cancellations at least 24 hours before a reservation.
cancellation.test.js:42
rejectedReceived acceptedA reservation 12 hours away can still be cancelled.
A framework for the way
you already build.
First target: OpenSpec + JavaScript tests.
Planned for v0.1.
THE WORKFLOW
Keep the behavior you want connected to the work you review. One focused change at a time.
Describe what should happen, the boundaries that matter, and what a good result looks like.
A clear specificationLink acceptance criteria to tests and observable outcomes. Keep the scope of each check explicit.
Evidence you can inspectSee what passed, what failed, and what still needs checking. Give your agent a precise next step.
A reviewable changeTHE PRINCIPLE
The first version is built around a simple idea: make the evidence as easy to review as the change itself.
Passed, failed, or still unverified. An incomplete check stays visible in the report.
Follow the connection from the expected behavior to the check and its recorded output.
Know which version and environment were checked, and when evidence needs refreshing.
SMALL STEPS. A CLEAR DIRECTION.
Start with acceptance. Grow through real use.
Here’s where we’re heading.
A focused loop from existing specs to checks, evidence, and a clear review.
Keep the link between intent and evidence useful as the project evolves.
Expand the same clear acceptance loop to more tools, stacks, and teams.
A LITTLE MORE CONTEXT
The framework is in early development. This landing includes a working interactive sample of the acceptance report. The v0.1 roadmap shows what we plan to implement first.
The goal is to fit your existing workflow. SDDFW will provide the specification and acceptance loop while your coding agent handles implementation. We’ll start with a focused integration and expand through real use.
A specific check succeeded for the recorded version and environment. The report should make that scope explicit. Missing checks remain unverified, and local results are identified as local results.
BUILD THE NEXT CHANGE WITH CLARITY.
A small first version.
A foundation for better development with AI.