프로필

어떤 워크플로우를 설치할지, 그리고 스킬, 명령, 또는 둘 다로 설치할지 선택합니다.

프로필은 머신 전체에 설치되는 OpenSpec 워크플로우(AI 도구의 스킬과 명령)에 대한 사용자의 선호 설정입니다. 기본 프로필은 core입니다. 워크플로우를 포함하거나 제외하면 해당 선택이 custom 프로필로 저장됩니다.

코어 세트

core 프로필은 아이디어부터 아카이브까지 전체 루프를 다루는 여섯 가지 워크플로우를 설치합니다:

워크플로우	용도
explore	변경 제안이 되기 전에 아이디어를 검토합니다
propose	변경 제안을 생성하고 모든 계획 아티팩트를 한 번에 생성합니다
apply	변경 제안의 작업을 구현합니다
update	변경 제안의 기존 계획 아티팩트를 수정합니다
sync	아카이브하지 않고 변경 제안의 스펙 업데이트를 specs/에 병합합니다
archive	완료된 변경 제안을 아카이브로 이동합니다

각 항목은 전체 계약 내용에 링크되어 있습니다: 인수, 생성하는 것, 그리고 응답 방식.

세트 확장: 선택적 워크플로우

코어 세트 외에도 여섯 가지 워크플로우를 추가로 사용할 수 있습니다. 그중 세 가지(new, continue, ff)는 propose처럼 한 번에 모두 생성하는 대신, 변경 제안 아티팩트를 하나씩 생성합니다.

워크플로우	용도
new	빈 스캐폴드로 변경 제안을 시작합니다
continue	변경 제안에서 다음 계획 아티팩트를 하나씩 생성합니다
ff	변경 제안과 구현에 필요한 모든 계획 아티팩트를 한 번에 생성합니다
verify	구현이 변경 제안의 아티팩트와 일치하는지 확인합니다
bulk-archive	여러 변경 제안을 한 번에 아카이브합니다
onboard	실제 변경 제안 하나를 처음부터 끝까지 수행하며 워크플로우를 익힙니다

세트를 변경하려면 대화형 선택기를 실행합니다:

openspec config profile

선택기에서 구성할 항목(딜리버리, 워크플로우, 또는 둘 다)을 묻고, 설치된 항목에 체크된 상태로 12개 워크플로우를 체크박스로 나열합니다. 코어 여섯 가지와 정확히 일치하지 않는 선택은 custom 프로필로 저장되므로, 사용하지 않는 코어 워크플로우의 체크를 해제할 수도 있습니다.

딜리버리: 스킬, 명령, 또는 둘 다

딜리버리는 스킬만 또는 명령만 설치하도록 선택할 수 있는 프로필 설정입니다. 기본값은 both입니다. 프로젝트 설정에서 두 형태와 왜 둘 다 존재하는지 설명합니다. 해당 필드의 정확한 계약은 CLI 설정 (config.json)을 참조하세요.

변경하는 두 가지 방법:

대화형으로: openspec config profile을 실행하고 "Delivery only"를 선택합니다. 스킬만으로 전환하는 예시:

Current profile settings
  Delivery: both

? What do you want to configure? Delivery only
? Delivery mode (how workflows are installed): Skills only

Config changes:
  delivery: both -> skills
? Apply changes to this project now? (Y/n) y

직접 설정: 명령 하나, 프롬프트 없음:

openspec config set delivery skills   # 또는: both, commands

딜리버리는 프로필 이름을 변경하지 않습니다. core와 custom는 워크플로우 세트만 설명하며, core로 다시 전환해도 딜리버리 설정은 유지됩니다.

프로필 전환

전환은 두 단계입니다: 머신에서 프로필을 변경한 다음, 각 프로젝트를 업데이트하여 적용합니다.

1. 프로필 변경:

   openspec config profile        # 대화형
   openspec config profile core   # 코어 여섯 가지로 초기화 (딜리버리 유지)

2. 작업 중인 각 프로젝트에서 업데이트를 실행합니다:

   openspec update

현재 디렉토리가 기존 OpenSpec 프로젝트인 경우, 대화형 흐름에서 해당 프로젝트에 대해 2단계를 실행하도록 제안합니다.