# OpenSPDD

A methodology and cross-platform CLI that turns AI coding prompts into structured design contracts with explicit constraints and dependencies, kept in sync with the implementation through reverse synchronization.

OpenSPDD stands for Structured Prompt-Driven Development. It is a methodology and command-line tool that treats an AI coding prompt not as a one-off instruction but as a design contract: a structured document with explicit constraints on what an agent may and may not do, precise details such as method signatures and error handling, and an explicit execution order for dependent steps.

Its core artifact is the REASONS Canvas, a seven-part structured framework covering design decisions, the implementation path and quality guardrails. A sync command lets the design document and the code it describes be reconciled in either direction as the implementation diverges from the plan, following the principle of fixing the prompt first and then updating the code.

It works with several AI coding tools, including Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode and Codex, auto-detects which one is in use, ships as a single Go binary with all templates embedded, and installs with Homebrew or Go install.

Website: https://github.com/gszhangwei/open-spdd
