gszhangwei/open-spdd

What it solves

OpenSPDD addresses the problem of "disposable" AI coding prompts and vague plan documents that lack constraints, precision, and traceability. It prevents AI from improvising freely or restructuring code arbitrarily by transforming prompts into executable design contracts, ensuring that the design and the actual implementation remain synchronized.

How it works

The project provides a cross-platform CLI tool that implements the REASONS Canvas, a 7-dimensional structured design framework (Requirements, Entities, Approach, Structure, Operations, Norms, and Safeguards).

Users follow a specific workflow:

1. Analysis: Perform strategic analysis of requirements.
2. Design: Generate a REASONS Canvas design document.
3. Generation: Use the canvas as a contract for the AI to generate precise code.
4. Sync: Use a reverse-synchronization command to update the design document when the code is refactored or changed.

Who it’s for

• Enterprise developers needing design-implementation traceability and long-term maintainability.
• Development teams wanting unified AI coding standards to reduce style conflicts.
• Developers performing complex refactoring who require a strict order of operations to avoid dependency chaos.

Highlights

• Cross-platform compatibility: Supports Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode, and Codex.
• Bidirectional Synchronization: Allows changes in code to be synced back to the design prompts.
• Structured Framework: Replaces simple task lists with a detailed contract specifying method signatures, DI patterns, and error handling.
• Auto-detection: Automatically identifies the AI coding environment to apply the correct configuration.