> **보존 안내** — 이 파일은 저장소 루트 `graphql-superpowers-package/` 에 있던 납품 패키지의 README다.
> 2026-08-15 문서 정리에서 설계서·계획서는 `docs/superpowers/specs/` 와 `docs/superpowers/plans/` 로 통합했고,
> `validate_graphql_docs.py` 와 `MANIFEST.sha256` 은 제거했다.
> 아래 본문은 납품 시점의 기록이므로 제거된 파일을 가리키는 문장은 더 이상 유효하지 않다.

# GraphQL Superpowers 설계 패키지

이 패키지는 `GraphQL API 실행 플랫폼 심층 리서치`를 구현 기준선으로 변환한 설계서와 실행 계획서다.

## 문서

- `docs/superpowers/specs/2026-08-12-graphql-api-execution-platform-design.md`
  - Stable·Advanced 전체 아키텍처, 공개 계약, 경계, 실패 의미론, 테스트와 지원 등급
  - 입력 심층 리서치 원문을 추적 부록으로 포함
- `docs/superpowers/plans/2026-08-12-graphql-api-execution-platform-implementation-plan.md`
  - Stable 구현 Task 1–48
- `docs/superpowers/plans/2026-08-12-graphql-advanced-capabilities-expansion-plan.md`
  - Stable Release Gate 이후 실행하는 Advanced·Experimental Task 1–19
- `VALIDATION.md`
  - 정적 검증 결과와 검증 범위
- `validate_graphql_docs.py`
  - 패키지 내부 문서 재검증 스크립트
- `MANIFEST.sha256`
  - 패키지 파일 무결성 목록

## 구현 순서

```text
Stable Task 1–48
→ Stable Release Gate
→ Advanced Task 1–19
→ Capability별 Promotion Gate
```

## 명시적 전제

```text
Java 21
Gradle Kotlin DSL
Spring Boot 4.1 BOM
Spring for GraphQL 2.0
Boot-managed GraphQL Java v25 계열
Stable module root: modules/graphql
Advanced module root: modules/graphql-advanced
Root package: io.backend.skeleton.graphql
```

실제 저장소에 적용할 때 기존 package·version catalog·module naming에 맞춰 경로만 조정하고, 문서의 공개 계약·불변 조건·테스트 의미는 유지한다.