gszhangwei/open-spdd

해결하는 문제

OpenSPDD는 제약, 정밀도, 추적성이 부족한 '일회성' AI 코딩 프롬프트와 모호한 계획 문서 문제를 해결합니다. 프롬프트를 실행 가능한 설계 계약으로 변환함으로써 AI가 임의로 코드를 재구성하거나 자유롭게 수정하는 것을 방지하여, 설계와 실제 구현이 항상 동기화되도록 보장합니다.

작동 방식

이 프로젝트는 7차원 구조화 설계 프레임워크인 REASONS Canvas(Requirements, Entities, Approach, Structure, Operations, Norms, and Safeguards)를 구현한 크로스 플랫폼 CLI 도구를 제공합니다.

사용자는 다음 워크플로우를 따릅니다:

1. 분석 (Analysis): 요구 사항에 대한 전략적 분석을 수행합니다.
2. 설계 (Design): REASONS Canvas 설계 문서를 생성합니다.
3. 생성 (Generation): 캔버스를 계약으로 사용하여 AI가 정확한 코드를 생성하도록 합니다.
4. 동기화 (Sync): 코드 리팩토링이나 변경 시 역동기화 명령을 사용하여 설계 문서를 업데이트합니다.

대상 사용자

• 엔터프라이즈 개발자: 설계-구현 추적성과 장기적인 유지보수성이 필요한 분.
• 개발 팀: AI 코딩 표준을 통합하여 스타일 충돌을 줄이고자 하는 팀.
• 복잡한 리팩토링을 수행하는 개발자: 의존성 혼란을 피하기 위해 엄격한 작업 순서가 필요한 분.

주요 특징

• 크로스 플랫폼 호환성: Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode, Codex를 지원합니다.
• 양방향 동기화: 코드의 변경 사항을 설계 프롬프트로 다시 동기화할 수 있습니다.
• 구조화된 프레임워크: 단순한 작업 목록을 메서드 시그니처, DI 패턴, 오류 처리를 명시한 상세한 계약으로 대체합니다.
• 자동 감지: AI 코딩 환경을 자동으로 식별하여 올바른 구성을 적용합니다.