# Table of Contents — OpenSpec 사용자 상세 가이드
> [!abstract] 개요
> AI 코딩 어시스턴트와 함께 **Spec-Driven Development(SDD)** 를 실천하기 위한 경량 프레임워크 OpenSpec의 완전 사용 가이드입니다.
## 챕터 목록
1. [[openspec-01-what-is-openspec|OpenSpec이란?]]
2. [[openspec-02-installation-and-setup|설치 및 초기 설정]] — npm/pnpm/yarn/bun/Nix/flake.nix 전체
3. [[openspec-03-core-concepts|핵심 개념 이해]] — Delta Specs, DAG, Progressive Rigor, 용어집
4. [[openspec-04-project-structure|프로젝트 구조]] ⭐ 단일 진실 공급원 — config.yaml 완전 레퍼런스
5. [[openspec-05-core-workflows|핵심 워크플로우]] — 슬래시↔CLI 매핑 표, 4가지 패턴
6. [[openspec-06-slash-commands-reference|슬래시 명령어 레퍼런스]] — 도구별 문법, verify 출력 예시, sync 사용 시기, 레거시 호환
7. [[openspec-07-cli-commands-reference|CLI 명령어 레퍼런스]] — 종료 코드, PowerShell 환경변수 포함
8. [[openspec-08-customization|커스터마이징]] — 3단계 레벨, 다국어 지원 8개 언어
9. [[openspec-09-supported-tools-and-integration|지원 AI 도구 및 통합]] — 30종+ 도구 전체 경로(init ID 포함)
10. [[openspec-10-advanced-usage-patterns|고급 사용 패턴]]
11. [[openspec-11-best-practices|베스트 프랙티스]] — 핵심 원칙 8가지, 안티패턴 6가지
12. [[openspec-12-migration-guide|마이그레이션 가이드]] — project.md→config.yaml 변환, 파일 구조도
13. [[openspec-13-troubleshooting|트러블슈팅]] — 8가지 케이스 (명령어 미인식, 아티팩트 미생성 등)
14. [[openspec-14-references|참고 자료]]
---
> [!tip] 빠른 시작
> OpenSpec을 처음 접한다면 [[openspec-01-what-is-openspec|1장]] → [[openspec-02-installation-and-setup|2장]] → [[openspec-05-core-workflows|5장]] 순서로 읽는 것을 권장합니다.
> [!info] 주요 레퍼런스 챕터
> - **폴더 구조 기준:** [[openspec-04-project-structure|4장]] (단일 진실 공급원)
> - **슬래시 명령어:** [[openspec-06-slash-commands-reference|6장]]
> - **CLI 명령어:** [[openspec-07-cli-commands-reference|7장]]
> - **config.yaml 설정:** [[openspec-08-customization|8장]]
> - **안티패턴 확인:** [[openspec-11-best-practices|11장 11.5절]]