Hacker News

OpenSpec – A lightweight and configurable AI spec framework

OpenSpec — 가볍고 설정 가능한 AI 스펙 프레임워크

OpenSpec은 소프트웨어 명세(spec)를 만들고 관리하기 위한 경량·설정 가능 프레임워크입니다. 만들고자 하는 것을 스펙에 담아 팀과 코딩 에이전트가 작업이 진행되는 동안에도 정렬되도록 돕고, 요구사항 정제와 검증, 구현 일치 확인까지 지원합니다. 커뮤니티에서는 SpecKit보다 가볍다는 평가와 함께 스펙 주도 개발(SDD) 도구로 주목받고 있습니다.

본문

OpenSpec은 "올바른 것을 만들고(build the right thing), 올바르게 만든다(build it right)"는 목표를 내세우는 스펙 프레임워크입니다. 핵심 아이디어는 만들고자 하는 소프트웨어의 모습을 스펙(spec) 문서에 포착한 뒤, 작업이 진화하더라도 팀원과 코딩 에이전트(coding agent)가 같은 방향을 유지하도록 돕는 것입니다. 요구사항을 다듬고(refine), 그것이 올바른 대상을 설명하는지 검증(validate)하며, 최종적으로 구현이 스펙과 일치하는지 확인(verify)하는 흐름을 제공합니다.

AI 코딩 시대의 스펙 주도 개발

최근 AI 코딩 에이전트를 활용하는 개발 방식에서는 에이전트가 요구사항을 잘못 해석해 엉뚱한 결과물을 만들거나, 작업이 길어질수록 초기 의도에서 벗어나는 문제가 자주 지적돼 왔습니다. OpenSpec은 이 문제를 스펙 문서를 중심축으로 두는 방식으로 풀려는 도구입니다. GitHub의 SpecKit 같은 기존 스펙 주도 개발(SDD) 도구와 유사한 철학을 공유하면서도, "경량(lightweight)"과 "설정 가능(configurable)"을 차별점으로 내세웁니다. 실제 사용자들의 평가에서도 무겁지 않다는 점이 반복적으로 언급되고 있습니다.

커뮤니티의 평가

반응은 대체로 호의적이지만 냉정한 지적도 있습니다. 한 사용자는 자체 에이전트 플릿에서 플래너 에이전트가 OpenSpec으로 계획을 생성하고 태스크를 티켓 그래프로 변환하는 파이프라인을 구축했으며, SpecKit보다 확실히 가볍다고 평가했습니다. 다른 사용자는 Superpowers, GSD, oh-my-claude/openagent 같은 도구들이 토큰을 과도하게 소모한다고 지적하며, OpenSpec이 브레인스토밍과 스펙 유지 관리의 균형을 잡아줄 것으로 기대했습니다.

반면 문서 품질에 대한 지적도 나왔습니다. 설정 문서에서 "Concepts"로 이어지는 링크가 실제 문서가 아닌 템플릿 저장소로 연결되는 등 문서 링크가 깨져 있다는 제보가 있었고, 이에 대해 사이트 리디자인이나 문서 이전 작업 중일 가능성이 있다는 변호성 댓글도 달렸습니다. 또한 유사한 철학의 경쟁 프로젝트(선언적 스펙과 설치 가능한 에이전트 스킬에 초점을 둔 Go 기반 단일 바이너리 도구)를 소개하는 자기 홍보성 댓글도 보였습니다.

Hacker News 반응

  • @slowmovintarget — 이걸 쓰고 있습니다. 좀 더 정확히는, 플래너 에이전트가 OpenSpec으로 계획을 생성한 뒤 태스크를 티켓 그래프로 변환하는 에이전트 플릿(맞춤형 하네스)을 만들었습니다. 꽤 잘 동작하고, SpecKit보다 확실히 가볍습니다.
  • @jeremyjh — 제가 필요하다고 생각하던 바로 그것처럼 보입니다. Superpowers, GSD, oh-my-claude/openagent를 써봤는데 대부분 토큰을 더 많이 태우더군요. 최근에는 기본 OMP를 쓰고 있는데 균형은 거의 맞지만 브레인스토밍과 스펙 유지 관리 기능이 부족했습니다. 간단한 걸 직접 얹어봤지만 결과가 들쭉날쭉했습니다.
  • @CharlieDigital — 이 섹션(설정 문서)이 "Concepts"로 링크하고, Concepts는 GitHub의 docs-lab 디렉터리로 이어집니다. 여기 있는 문서들은 전부 실제 파일이 아니라 템플릿이네요(실제 파일은 docs 디렉터리에 있는 것으로 추정). 솔직히 그다지 신뢰가 가지 않습니다.
  • @silvertab — 사이트를 리디자인하거나 문서를 옮기는 중인 것 같습니다. 얼마 전까지만 해도 다 잘 동작했는데, 마지막으로 확인했을 때 사이트 디자인이 완전히 바뀌어 있었습니다.
  • @wyum — openspec을 처음 봤는데, 올해 제가 작업해온 것과 비슷한 철학을 공유하는 것 같습니다. 이 프로젝트나 SDD가 마음에 드신다면 제 프로젝트 spekk-cli에 대한 피드백을 부탁드립니다. 유사한 반복적 스펙 철학이지만, 선언적 스펙과 설치 가능한 에이전트 스킬에 집중한다는 점이 다릅니다. 단순함과 최소 요구사항(단일 바이너리)을 위해 Go를 선택했습니다.

원문: Hacker News / 번역·요약: Trawling

원문 보기 ↗토론 보기 ↗