backend-api-contracts

name	backend-api-contracts
description	웹앱 백엔드의 API 계약, 인증 규칙, CRUD 응답 형식을 정리하는 backend-builder 전용 스킬.

Backend API Contracts

Target Agent

backend-builder

Trigger

• architecture 문서가 준비되었다
• frontend와 맞물릴 API 계약이 필요하다
• 인증/권한/응답 규칙을 구현 전에 먼저 고정해야 한다

Inputs

• _workspace/02_architecture.md
• _workspace/01_requirements.md
• 데이터 흐름 / API 경계 초안

Codex Runtime Context

• bound runtime relation: backend
• actual execution runtime: https://github.com/coreline-ai/agent-team-module

Purpose

구현 전에 API 계약을 먼저 고정한다.

Patterns / Checklists

• 리소스별 CRUD 엔드포인트
• 인증/권한 기본안
• 오류 응답 형식
• 입력 검증 포인트
• 데이터 타입/제약 결정 시 근거를 한 줄 기록 (예: 가격을 Int로 쓴 이유)

Rules

• architecture 에 없는 리소스를 임의 추가하지 않는다.
• frontend가 소비할 응답 형식을 명시한다.
• 인증 규칙과 관리자 경계를 분리한다.

Output Format Rules

• 엔드포인트는 "Method | Endpoint | 설명 | 인증 | 요청 Body | 응답" 테이블로 정리한다.
• 오류 응답은 코드 블록으로 JSON 구조를 보여준다.
• 02_architecture에서 정의한 용어/enum을 그대로 사용한다.
• 문서 끝에 ## Downstream Handoff Note 섹션을 포함한다.

Output Guidance

• _workspace/04_backend_plan.md 에 엔드포인트 표를 포함한다.

Completion Criteria

• 주요 리소스별 엔드포인트, 인증 규칙, 오류 응답 형식이 정리된다.
• frontend와 QA가 계약 충돌을 확인할 수 있다.

Downstream Handoff

• qa-reviewer와 frontend-builder가 계약 충돌을 검토할 수 있게 응답 형식을 명확히 남긴다.