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/ 폴더 내의 양식들이 팀 표준 항목(필수 가이드 주석 포함)을 갖추고 있는지 확인하세요.
• 에이전트는 향후 모든 작업을 이 표준 양식에 맞추어 기록하게 됩니다.

참조 템플릿

• 팀 표준 규약 템플릿
• 기능정의서 양식
• 구현보고서 양식
• 작업수행이력서 양식
• 수정영향도보고서 양식