# 10. 고급 사용 패턴
← [[openspec-09-supported-tools-and-integration|9. 지원 AI 도구 및 통합]] | 다음 → [[openspec-11-best-practices|11. 베스트 프랙티스]]
---
## 10.1 아키텍처 결정 기록 (ADR) 통합
`spec-driven-with-adr` 스키마를 사용하면 아키텍처 결정을 별도로 영구 보관할 수 있다.
```bash
openspec schema fork spec-driven spec-with-adr
# schema.yaml에 adr 아티팩트 추가
openspec config set schema spec-with-adr
```
> [!note]
> ADR을 통해 "왜 이 결정을 했는가"를 추적하여 미래 설계 시 컨텍스트로 활용할 수 있다.
## 10.2 CI/CD 파이프라인 통합
```yaml
# .github/workflows/openspec-validate.yml
name: OpenSpec Validation
on: [pull_request]
jobs:
validate:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- uses: actions/setup-node@v4
with:
node-version: '20'
- name: Install OpenSpec
run: npm install -g @fission-ai/openspec@latest
env:
OPENSPEC_TELEMETRY: 0
- name: Validate specs
run: openspec validate --all --strict --no-interactive
- name: Check changes status
run: openspec status --json
```
> [!tip] CI 환경 필수 설정
> `OPENSPEC_TELEMETRY: 0` — CI에서 자동 비활성화되지만, 명시적으로 설정 권장
## 10.3 멀티 저장소 워크스페이스
```bash
# 워크스페이스 초기 설정
openspec workspace setup \
--name fullstack-app \
--link frontend=./packages/frontend \
--link backend=./packages/backend \
--link mobile=./packages/mobile
# 다른 머신에서 경로 재연결
openspec workspace relink
# 상태 확인
openspec workspace doctor
# 워크스페이스 열기
openspec workspace open --workspace fullstack-app --agent claude
```
> [!warning] 주의사항
> 워크스페이스 기능은 활발히 개발 중으로, 프로덕션 환경에서는 안정성을 충분히 검증한 후 사용한다.
## 10.4 Git WorkTrees와 병렬 개발
병렬 기능 개발 시 Git Worktree와 OpenSpec을 조합:
```bash
# 새 worktree에서 feature A 작업
git worktree add ../project-feature-a feature-a
cd ../project-feature-a
/opsx:propose add-feature-a
# 메인에서 feature B 작업
cd ../project
/opsx:propose add-feature-b
```
## 10.5 기존 프로젝트 점진적 마이그레이션
```bash
# 1. OpenSpec 초기화
openspec init
# 2. 현재 시스템 동작을 스펙으로 문서화 (AI 보조)
/opsx:explore 현재 인증 모듈 동작 방식을 specs/ 형식으로 문서화해줘
# 3. 신규 기능부터 OpenSpec 워크플로우 적용
/opsx:propose add-new-feature
# 4. 점진적으로 레거시 코드 커버리지 확장
```
> [!success] Brownfield 프로젝트 전략
> 기존 코드를 완전히 재작성하지 않고도 현재 상태를 점진적으로 캡처하여 레거시 시스템 현대화에 효과적으로 활용할 수 있다.
---
← [[openspec-09-supported-tools-and-integration|9. 지원 AI 도구 및 통합]] | 다음 → [[openspec-11-best-practices|11. 베스트 프랙티스]]