Fission-AI/OpenSpec

→ 경직되지 않은 유연함 (fluid not rigid)
→ 폭포수 모델이 아닌 반복적 방식 (iterative not waterfall)
→ 복잡하지 않은 간결함 (easy not complex)
...

팁 (Tip)

새로운 워크플로우(workflow)를 이제 사용할 수 있습니다! 우리는 새로운 아티팩트 가이드 워크플로우(artifact-guided workflow)를 통해 OpenSpec을 재구축했습니다.

시작하려면 /opsx:propose "당신의 아이디어"를 실행하세요. → 자세한 내용은 여기에서 확인하세요.

업데이트를 위해 X에서 @0xTab을 팔로우하거나, 도움 및 질문을 위해 OpenSpec Discord에 참여하세요.

사용자: /opsx:propose add-dark-mode
AI: openspec/changes/add-dark-mode/ 생성됨/
✓ proposal.md — 우리가 이것을 수행하는 이유, 변경되는 사항
...

Node.js 20.19.0 이상 버전이 필요합니다.

OpenSpec을 전역(globally)으로 설치하세요:

npm install -g @fission-ai/openspec@latest

그 다음 프로젝트 디렉토리로 이동하여 초기화하세요:

cd your-project
openspec init

이제 AI에게 다음과 같이 말하세요: /opsx:propose <만들고 싶은 것>

확장된 워크플로우(/opsx:new, /opsx:continue, /opsx:ff, /opsx:verify, /opsx:bulk-archive, /opsx:onboard)를 사용하려면, openspec config profile로 선택한 후 openspec update로 적용하세요.

참고 (Note)

사용 중인 도구가 지원되는지 확실하지 않으신가요? 전체 목록을 확인하세요 – 우리는 25개 이상의 도구를 지원하며 계속 늘려나가고 있습니다.

또한 pnpm, yarn, bun, nix와도 작동합니다. 설치 옵션을 확인하세요.

→ 시작하기 (Getting Started): 첫 단계

→ 워크플로우 (Workflows): 조합 및 패턴

→ 명령어 (Commands): 슬래시 명령어(slash commands) 및 스킬(skills)

→ CLI: 터미널 참조

→ 지원되는 도구 (Supported Tools): 도구 통합 및 설치 경로

→ 개념 (Concepts): 모든 것이 어떻게 결합되는지

→ 다국어 (Multi-Language): 다국어 지원

→ 커스터마이징 (Customization): 자신에게 맞게 설정하기

독립된 저장소를 통해 배포되는 제3자 스키마 번들(Third-party schema bundles) — 이들은 github/spec-kit의 커뮤니티 확장 카탈로그가 도구 통합을 처리하는 방식과 유사하게, OpenSpec을 다른 도구와 통합하는 정형화된 워크플로우를 제공합니다.

→ 커스터마이징 문서에서 카탈로그를 찾아보세요.

AI 코딩 어시스턴트(AI coding assistants)는 강력하지만, 요구사항이 채팅 기록에만 존재할 경우 예측 불가능할 수 있습니다. OpenSpec은 가벼운 스펙 레이어(spec layer)를 추가하여, 코드가 작성되기 전에 무엇을 만들지에 대해 합의할 수 있도록 합니다.

구축하기 전에 합의하세요 — 코드가 작성되기 전에 인간과 AI가 스펙(specs)에 대해 정렬합니다.
체계적인 관리 — 각 변경 사항은 제안(proposal), 스펙(specs), 설계(design), 작업(tasks)을 포함하는 고유한 폴더를 가집니다.
유연한 작업 흐름 — 경직된 단계별 게이트(phase gates) 없이 언제든 모든 아티팩트(artifact)를 업데이트할 수 있습니다.
기존 도구 활용 — 슬래시 명령어(slash commands)를 통해 20개 이상의 AI 어시스턴트와 함께 작동합니다.

vs. Spec Kit (GitHub) — 철저하지만 무겁습니다. 경직된 단계별 게이트, 방대한 양의 Markdown, Python 설정이 필요합니다. OpenSpec은 더 가볍고 자유로운 반복(iterate)을 허용합니다.

vs. Kiro (AWS) — 강력하지만 해당 IDE에 종속되며 Claude 모델로 제한됩니다. OpenSpec은 여러분이 이미 사용 중인 도구들과 함께 작동합니다.

vs. 아무것도 사용하지 않음 — 스펙 없는 AI 코딩은 모호한 프롬프트와 예측 불가능한 결과를 초래합니다. OpenSpec은 번거로운 절차 없이 예측 가능성을 가져다줍니다.

패키지 업그레이드

npm install -g @fission-ai/openspec@latest

에이전트 지침(agent instructions) 갱신

각 프로젝트 내부에서 다음 명령어를 실행하여 AI 가이드를 재생성하고 최신 슬래시 명령어(slash commands)가 활성화되었는지 확인하세요:

openspec update

모델 선택: OpenSpec은 추론 능력이 높은 모델과 함께 사용할 때 가장 효과적입니다. 계획(planning)과 구현(implementation) 모두를 위해 Opus 4.5 및 GPT 5.2를 권장합니다.

컨텍스트 위생(Context hygiene): OpenSpec은 깨끗한 컨텍스트 창(context window)에서 이점을 얻습니다. 구현을 시작하기 전에 컨텍스트를 정리하고, 세션 내내 좋은 컨텍스트 위생을 유지하세요.

작은 수정 사항 — 버그 수정, 오타 교정 및 사소한 개선 사항은 PR(Pull Request)로 직접 제출할 수 있습니다.

더 큰 변경 사항 — 새로운 기능, 대규모 리팩터링(refactors) 또는 아키텍처 변경의 경우, 구현이 시작되기 전에 의도와 목표를 맞출 수 있도록 먼저 OpenSpec 변경 제안(change proposal)을 제출해 주세요.

제안서를 작성할 때는 OpenSpec의 철학을 염두에 두시기 바랍니다. 우리는 다양한 코딩 에이전트, 모델 및 사용 사례에 걸쳐 매우 폭넓은 사용자들에게 서비스를 제공합니다. 변경 사항은 모든 사람에게 잘 작동해야 합니다.

AI 생성 코드는 환영합니다 — 테스트와 검증을 거쳤다면 말이죠. AI 생성 코드가 포함된 PR (Pull Request)에는 사용된 코딩 에이전트와 모델을 명시해야 합니다 (예: "Generated with Claude Code using claude-opus-4-5-20251101").

• 의존성 설치:
  pnpm install

• 빌드:
  pnpm run build

• 테스트:
  pnpm test

• CLI 로컬 개발:
  pnpm run dev

또는 pnpm run dev:cli

• Conventional commits (한 줄 형식):
  type(scope): subject

텔레메트리 (Telemetry)

OpenSpec은 익명의 사용 통계를 수집합니다.

사용 패턴을 이해하기 위해 오직 명령어 이름과 버전만을 수집합니다. 인자(arguments), 경로(paths), 내용(content) 또는 개인 식별 정보(PII)는 수집하지 않습니다. CI (Continuous Integration) 환경에서는 자동으로 비활성화됩니다.

수집 거부 (Opt-out): export OPENSPEC_TELEMETRY=0

또는 export DO_NOT_TRACK=1

메인테이너 및 어드바이저 (Maintainers & Advisors)

프로젝트를 안내하는 데 도움을 주는 핵심 메인테이너 및 어드바이저 목록은 MAINTAINERS.md를 참조하세요.

MIT