OpenSpec, Node.js 없는 실행 파일과 지침 변경 미리보기 추가

AI 코딩 작업의 명세를 관리하는 OpenSpec이 Node.js 없이 실행되는 독립 배포판을 추가했다. 10월 24일 공개된 v1.15.0에는 지침 파일을 고치기 전에 변경 목록을 확인하는 미리보기도 들어갔다. GitHub가 기록한 안정 릴리스 공개 시각은 이날 오전 9시 50분 5초 KST이다.

OpenSpec은 코드를 쓰기 전에 제안서와 요구사항, 설계, 작업 목록을 변경별 폴더에 정리하는 도구다. 공개 README의 작업 예시는 사용자가 계획을 검토한 뒤 AI 코딩 도구에서 구현을 진행하는 흐름을 보여 준다. 이번에 바뀐 것은 이 도구의 배포 형태와 지침 갱신 방식이다. 프로그램이 독립 파일이 됐어도 실제 개발 작업은 기존처럼 코딩 도구 안에서 이어진다.

새 배포판은 macOS의 Apple silicon·Intel, Linux의 x64·arm64, Windows의 x64·arm64를 지원한다. Linux 빌드는 glibc·musl로 구분하며 전체 배포 파일은 여덟 개다. 설치기는 기기에 맞는 파일을 고르고 SHA256SUMS와 대조한다. 자산 업로드가 끝나지 않은 최신 릴리스가 있으면 파일이 모두 준비된 이전 릴리스를 선택하고 이를 알린다.

지원 기준은 macOS 13 이상, Windows 10 이상, glibc 2.17 이상 또는 Alpine 3.17 이상이다. Alpine에는 C++ 실행 라이브러리가 별도로 필요하다. npm 방식도 유지되며 이 경로에는 Node.js 20.19.0 이상이 필요하다. 전환은 선택 사항이며 설정·프로젝트를 유지한다. 재초기화는 필요 없다.

전환 명령인 openspec install은 독립 실행 파일을 설치한 뒤 예전 패키지 설치본을 제거할 명령을 출력한다. 예전 설치본을 직접 지우지는 않는다. 명령 검색 경로에서 그 파일이 앞에 있으면 계속 예전 설치본이 실행될 수 있다. 이미 독립 배포판을 쓰는 경우에는 실행 파일이 있던 위치와 이름을 유지하며 교체한다.

반면 openspec update의 주된 대상은 프로젝트에 생성된 AI 지침과 명령 파일이다. 새 --dry-run 옵션은 비대화형 갱신이 만들 변경을 미리 계산하고 파일은 쓰지 않는다. 이때 CLI 업그레이드 확인과 사용자 질문도 생략한다. --json을 함께 주면 변경 계획을 기계가 읽을 수 있는 문서로 내보내며, --force와 조합하면 강제 갱신 범위를 확인한다.

계획에는 추가·수정·삭제할 경로와 해당 도구, 확인이 필요한 이전 형식의 흔적, 도구별 실패가 나뉘어 담긴다. 구현은 앞 단계의 가상 변경을 다음 단계가 읽도록 하고 디스크의 원래 내용과 최종 내용을 비교한다. 같은 바이트를 다시 쓰거나 새 파일을 만들었다 곧 지우는 경우는 최종 변경에서 빠진다. 쓰기 권한 같은 실패는 해당 도구의 계획을 그 지점에서 멈추고 다른 도구의 계획은 계속 기록한다.

같은 릴리스는 삭제된 요구사항을 비슷한 이름의 새 요구사항과 혼동하던 검토 지침도 고쳤다. #2114 PR에 따르면 이제 정규화한 정확한 이름으로 기준 요구사항을 찾고, 현재 명세에 없으면 Git 이력을 확인하도록 안내한다. 수정 대상은 에이전트가 읽는 지침 텍스트이며 작성자는 실제 에이전트로 재현 사례를 다시 실행하지 않았다고 명시했다.