Fission-AI/OpenSpec

해결하는 문제

AI 코딩 어시스턴트는 프로젝트 컨텍스트가 일시적인 채팅 기록에 갇혀 있기 때문에 모호한 요구 사항과 예측할 수 없는 출력으로 인해 어려움을 겪는 경우가 많습니다. OpenSpec은 경량화된 구조적 사양 계층을 제공하여 코드가 작성되기 전에 인간 개발자와 AI 간의 조정을 강제함으로써 양측이 요구 사항, 설계 및 구현 작업에 동의하도록 보장합니다.

작동 방식

OpenSpec은 리포지토리 내에 표준화된 폴더 구조(specs/, changes/)를 도입하여 프로젝트 요구 사항과 계획을 일반 Markdown 파일로 저장합니다. 기존 AI 코딩 어시스턴트(Cursor, GitHub Copilot, Amazon Q 등) 내에서 슬래시 명령(예: /opsx:propose, /opsx:apply)을 사용하여 상호 작용합니다. 워크플로는 아이디어 탐색, 기술 계획 제안, 작업 구현, 결과 아카이빙의 주기를 따르며, AI가 개발 프로세스 전반에 걸쳐 참조할 수 있는 지속적인 의도 기록을 생성합니다.

대상 사용자

AI 지원 코딩의 신뢰성과 예측 가능성을 향상시키려는 개인 개발자와 소프트웨어 팀을 위해 설계되었습니다. 특히 여러 리포지토리에 걸쳐 작업하며 코딩 에이전트가 액세스할 수 있는 공유되고 일관된 요구 사항의 진실 공급원(source of truth)이 필요한 팀에게 유용합니다.

주요 특징

• 도구 독립적: 간단한 슬래시 명령을 통해 30개 이상의 다양한 AI 코딩 어시스턴트 및 IDE와 함께 작동합니다.
• 인간-AI 조정: AI가 구현을 시작하기 전에 공식적인 제안과 사양 검토를 요구하여 환각(hallucinations)과 범위 확장(scope creep)을 줄입니다.
• 교차 리포지토리 계획: "Stores"(베타)를 지원하여 여러 코드베이스가 참조할 수 있는 중앙 사양 리포지토리를 유지할 수 있습니다.
• 경량 및 반복적: 엄격하고 복잡한 프레임워크 대신 간단한 Markdown 파일을 사용하여 프로젝트 요구 사항이 진화함에 따라 유연하게 업데이트할 수 있습니다.
• 내장 워크플로: 프로젝트 디렉토리 내에서 직접 작업 목록, 설계 문서 및 변경 로그 생성을 자동화합니다.