보존 안내 — 이 파일은 저장소 루트
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- 패키지 파일 무결성 목록
구현 순서
Stable Task 1–48
→ Stable Release Gate
→ Advanced Task 1–19
→ Capability별 Promotion Gate
명시적 전제
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에 맞춰 경로만 조정하고, 문서의 공개 계약·불변 조건·테스트 의미는 유지한다.