architecture-blueprint-starter

name	architecture-blueprint-starter
description	웹앱 구조, 데이터 흐름, API 경계, 폴더 구조 초안을 만드는 solution-architect 전용 스킬.

Architecture Blueprint Starter

Target Agent

solution-architect

Trigger

• 요구사항 문서가 준비되었다
• 구현 전 구조/경계/API 계약 초안이 필요하다
• frontend/backend/operations가 공통으로 읽을 구조 문서가 필요하다

Inputs

• _workspace/01_requirements.md
• _workspace/00_input.md
• package-level stack/default assumptions

Codex Runtime Context

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

Purpose

요구사항을 구조 문서로 바꾼다.

Patterns / Checklists

• 페이지/모듈 경계
• frontend/backend 분리 기준
• API 계약 초안 (엔드포인트 수를 명시하고, 이후 backend-builder가 변경 시 이 문서도 갱신)
• 폴더 구조
• 주요 기술 선택마다 "선택 | 버린 대안 | 선택 이유" 를 한 줄 기록
• 핵심 용어/상태/enum 을 정의하고, 이후 모든 문서가 이 정의를 따른다

Rules

• requirements 문서에 없는 큰 기능을 추가하지 않는다.
• downstream agent가 병렬로 읽을 수 있게 공통 제약을 명확히 한다.
• API/데이터 흐름/폴더 구조를 최소 한 번씩 명시한다.

Output Format Rules

• 기술 스택은 "계층 | 선택 | 버린 대안 | 선택 이유" 테이블로 정리한다.
• API 경계는 "리소스 | Method | Endpoint | 인증" 테이블로 정리한다.
• 핵심 용어/상태명/enum 을 별도 섹션 또는 테이블로 정의한다 (이후 모든 문서가 이 정의를 따름).
• 문서 끝에 ## Downstream Handoff Note 섹션을 포함한다.

Output Guidance

• _workspace/02_architecture.md 에 handoff 메모를 포함한다.

Completion Criteria

• frontend/backend/operations가 같은 구조 문서를 읽고 작업할 수 있다.
• API 경계와 데이터 흐름이 requirements 대비 모순되지 않는다.

Downstream Handoff

• frontend-builder, backend-builder, operations-packager가 공통 제약을 읽을 수 있게 한다.