gszhangwei/open-spdd

해결하는 문제

OpenSPDD는 일시적인 AI 코딩 프롬프트와 모호한 계획 문서로 인해 AI가 즉흥적으로 코드를 생성하고, 추적 불가능하며 설계가 흐려지는 문제를 해결합니다. 이 도구는 AI 프롬프트를 실행 가능한 설계 계약으로 변환하여, AI가 고수준 작업 목록을 생성하는 것이 아니라 정확한 아키텍처 패턴과 코딩 표준을 따르도록 보장합니다.

작동 방식

이 프로젝트는 Cursor, Claude Code, GitHub Copilot 등 다양한 AI 코딩 환경과 통합 가능한 크로스플랫폼 CLI 도구를 제공합니다. REASONS Canvas라는 7차원 구조화 설계 프레임워크(요구사항, 엔티티, 접근 방식, 구조, 운영, 규범, 보호 조치)를 구현하여 기능의 "왜", "무엇", "어떻게"를 정의합니다.

사용자는 다음과 같은 구조화된 워크플로우를 따릅니다: 전략적 분석 → REASONS Canvas 생성 → 코드 생성 → 역방향 동기화. CLI 도구는 AI 도구의 네이티브 명령 시스템 내에서 이러한 단계를 트리거하기 위해 필요한 템플릿과 명령 파일을 관리합니다.

대상 사용자

• 기업 개발자: 설계-구현 추적성과 장기적인 유지보수성이 필요한 사용자.
• 개발 팀: 스타일 갈등을 줄이기 위해 통일된 AI 코딩 기준을 원하는 팀.
• 아키텍트: 종속성 혼란을 방지하기 위해 엄격한 운영 순서가 필요한 복잡한 리팩터링을 수행하는 사용자.

주요 기능

• 양방향 동기화: 코드 변경 사항을 설계 문서로 다시 동기화하여 프롬프트와 구현이 일치하도록 유지.
• 크로스플랫폼 지원: Cursor, Claude Code, GitHub Copilot, Antigravity, OpenCode, Codex와 호환.
• 구조화된 프레임워크: REASONS Canvas를 사용해 명확한 메서드 시그니처, 에러 처리, DI 패턴을 지정 가능. 모호한 지시가 아닌 정확한 지시 가능.
• 자동 감지: 활성화된 AI 코딩 환경을 자동으로 식별하여 올바른 명령 디렉터리를 설정.