# Team Blueprint Scaffold

> 팀 표준 Next.js + FastAPI + GCP 아키텍처를 기반으로 새로운 프로젝트를 스캐폴딩합니다. /{카테고리}/{앱이름} 라우팅 규칙과 팀의 골든 룰(GEMINI.md), 그리고 표준화된 4종 문서 양식을 자동으로 주입하여 일관된 개발 환경을 구축합니다.

- Skill: `lsw417/team-blueprint-scaffold` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds@latest add lsw417/team-blueprint-scaffold`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lsw417/team-blueprint-scaffold/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: lsw417 (https://skillmd.com/u/lsw417)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/lsw417/team-blueprint-scaffold

---


# Team Blueprint Scaffold

팀의 표준 기술 스택과 운영 컨벤션을 내재화한 프로젝트 초기화 스킬입니다. 단순히 코드를 생성하는 것을 넘어, 에이전트가 향후 작업을 수행할 때 지켜야 할 '헌법'(`GEMINI.md`)과 일관된 보고 체계를 위한 **표준 문서 양식**을 함께 주입합니다.

## 핵심 가치
- **Standardized Foundation**: Next.js, FastAPI, GCP 설정을 팀 표준에 맞게 자동 구성합니다.
- **Routing Enforcement**: `{카테고리}/{앱이름}` 접두어를 모든 라우팅 설정에 자동 주입합니다.
- **Unified Documentation**: 기능정의서, 구현보고서 등 4종의 표준 양식을 제공하여 보고 체계를 일원화합니다.
- **Golden Rules Injection**: 에이전트 가이드라인(`GEMINI.md`)을 생성하여 작업 절차와 규칙을 강제합니다.

## 수행 프로세스 (Workflow)

### 1. 정보 수집 (Checklist)
스킬 실행 시 사용자에게 다음 정보를 요청하여 변수로 활용합니다.
- **App Category**: (예: `admin`, `service`)
- **App Name**: (예: `payment`, `dashboard`)
- **GCP Credential Path**: 로컬 개발용 서비스 계정 키 파일 경로.

### 2. 프로젝트 스캐폴딩 (Scaffolding)
`assets/`의 템플릿을 사용하여 다음 구조를 생성합니다.
- **`frontend/`**: Next.js 뼈대 생성 및 `next.config.js`의 `basePath` 자동 치환.
- **`backend/`**: FastAPI 뼈대 생성 및 `root_path` 자동 치환.
- **`docs/`**: 다음 4종의 표준 문서 양식을 포함하여 폴더 구조를 생성합니다.
    - `기능정의서`: `functional-spec-template.md` 사용.
    - `구현보고서`: `implementation-report-template.md` 사용.
    - `작업수행이력서`: `task-history-template.md` 사용.
    - `수정영향도보고서`: `impact-analysis-template.md` 사용.
- **`deploy/`**: `cloudbuild.yaml`, `Dockerfile` 템플릿 생성.
- **`PROJECT.md`**: 작업자 지시사항 파일 생성.

### 3. 규약 주입 (Guardrails)
프로젝트 루트에 `GEMINI.md`를 생성하여 팀의 8단계 개발 프로세스와 GCP 명명 규칙 등을 강제합니다.

## 활용 가이드
- "신규 프로젝트 'admin' 카테고리의 'user-manager' 앱을 세팅해줘"라고 요청하세요.
- 생성 완료 후 `docs/` 폴더 내의 양식들이 팀 표준 항목(필수 가이드 주석 포함)을 갖추고 있는지 확인하세요.
- 에이전트는 향후 모든 작업을 이 표준 양식에 맞추어 기록하게 됩니다.

## 참조 템플릿
- [팀 표준 규약 템플릿](assets/gemini-guardrail.md)
- [기능정의서 양식](assets/functional-spec-template.md)
- [구현보고서 양식](assets/implementation-report-template.md)
- [작업수행이력서 양식](assets/task-history-template.md)
- [수정영향도보고서 양식](assets/impact-analysis-template.md)