AI 개발 과정의 요구사항 합의를 돕는 OpenSpec 프레임워크
Fission-AI/OpenSpec
GitHubAI 개발 과정에서 인간과 기계가 사전에 기능의 요구사항(Spec)에 합의하도록 돕는 경량화된 개발 프레임워크입니다.
- 요구사항, 기술적 접근 방식, 구현 태스크 등을 체계적인 Markdown 아티팩트로 생성하여 계획 단계를 명확히 문서화합니다.
- 단순 코드 생성을 넘어 프로젝트 전체의 변경 사항을 중앙 집중식으로 관리하여, 복잡한 팀 환경에서도 높은 개발 투명성을 보장합니다.
- 사용을 위해서는 Node.js 환경과 전역 CLI 설치가 필수이며, 최적의 결과를 위해 높은 추론 능력을 가진 AI 모델 연동이 권장됩니다.
OpenSpec은 AI 코딩 어시스턴트 사용 시 발생할 수 있는 모호한 요구사항 문제를 해결하기 위해 설계된 경량화된 스펙 레이어입니다. 이 프레임워크는 개발자가 코드 작성에 앞서 인간과 AI가 구축할 기능의 요구사항에 합의하도록 돕습니다. 각 변경 사항은 자체 폴더 내에서 제안서, 스펙, 디자인, 태스크 등의 구조화된 아티팩트로 관리되어 높은 개발 투명성을 제공하며, 유연한 반복(fluid) 방식을 지향합니다.
OpenSpec은 새로운 아티팩트 기반 워크플로우를 통해 사용됩니다. 초기 아이디어를 탐색할 때는 `/opsx:explore` 명령을 사용하여 코드를 읽고 옵션을 제시받을 수 있으며, 구체적인 기능을 제안하려면 `/opsx:propose <기능>`을 실행합니다. 이 과정에서 OpenSpec은 `proposal.md`, `specs/`, `design.md`, `tasks.md` 등의 구조화된 파일을 생성하여 계획 단계를 명확히 문서화하며, 이후 `/opsx:apply`로 태스크를 구현하고 `/opsx:archive`로 변경 사항을 아카이브합니다.
이 프레임워크를 사용하려면 Node.js 20.19.0 이상 버전이 필요하며, 전역 CLI 설치(`npm install -g @fission-ai/openspec@latest`) 후 프로젝트 초기화(`openspec init`)가 필수입니다. 특히 'Stores' 기능은 하나의 소스(source of truth)에서 여러 리포지토리에 걸친 크로스-리포지토리 기능을 계획할 수 있게 하여, 팀 전체의 협업과 개발 과정을 중앙 집중식으로 관리하는 데 도움을 줍니다.