Fission-AI/OpenSpec

해결하는 문제

OpenSpec은 요구사항이 채팅 기록에만 저장될 때 AI 코딩 어시스턴트의 예측 불가능성을 해결합니다. 코드가 작성되기 전에 인간과 AI가 정확히 무엇을 구현할지 일치시킬 수 있는 가벼운 사양 계층을 제공하여 모호한 프롬프트와 예측 불가능한 결과를 줄입니다.

작동 방식

OpenSpec은 슬래시 명령어(예: /opsx:propose)를 통해 30개 이상의 AI 어시스턴트와 통합되어 아티팩트 기반 워크플로우를 구현합니다. 개발을 구조화된 openspec/ 디렉터리에 정리하며, 제안, 요구사항(사양), 기술 설계, 구현 체크리스트용 일반적인 Markdown 파일을 포함합니다.

주요 워크플로우:

• Explore: 옵션을 평가하고 계획을 세우기 위해 사고 파트너로 /opsx:explore 사용.
• Propose: 기능용 전용 폴더를 생성하고 제안, 사양, 설계, 작업을 포함하기 위해 /opsx:propose 사용.
• Apply: 정의된 작업을 구현.
• Archive: 완료된 변경 사항을 아카이브로 이동하여 활성 워크스페이스를 정리.
• Stores: 팀이 사양을 별도의 리포지토리에 유지할 수 있는 베타 기능으로, 여러 코드 리포지토리 간에 공유되는 유일한 진실 소스를 생성.

대상 사용자

AI 코딩 어시스턴트(Cursor, GitHub Copilot, Amazon Q, Codex 등)를 사용하며 기능 요구사항과 구현을 더 예측 가능하고 체계적이며 확장 가능한 방식으로 관리하고자 하는 개별 개발자 및 엔지니어 팀을 위한 것입니다.

주요 특징

• 도구 독립성: 맞춤형 슬래시 명령어를 통해 30개 이상의 AI 어시스턴트와 호환.
• 아티팩트 기반: 요구사항과 시나리오에 일반 Markdown 사용으로 사양의 가독성과 검토 용이성 확보.
• 다중 리포지토리 계획 지원: "Stores" 기능을 통해 여러 리포지토리에 걸쳐 있는 기능의 사양을 관리 가능.
• 유연한 워크플로우: 엄격한 단계 제한을 피하고 언제든지 어떤 아티팩트도 반복 업데이트 가능.