요구사항 명세를 기반으로 프로젝트 구조와 CI 파이프라인을 설정합니다. "프로젝트 초기화해줘", "프로젝트 부트스트랩", "CI 설정해줘", "프로젝트 구조 만들어줘" 등을 요청할 때 활성화됩니다.
Sets up project structure and CI pipeline based on requirements specifications.
/plugin marketplace add dlddu/claude-plugin-marketplace/plugin install agile-workflow@dlddu-pluginsThis skill inherits all available tools. When active, it can use any tool Claude has access to.
scripts/check-ci.sh이 스킬은 요구사항 명세서를 기반으로 프로젝트의 아키텍처를 설계하고, GitHub Actions를 사용한 CI 파이프라인을 구성합니다. Hello World 수준의 기본 구현과 Health Check 엔드포인트를 포함하여 CI가 정상 동작하는 것을 검증합니다.
다음과 같은 요청 시 이 스킬이 활성화됩니다:
docs/specs/ 디렉토리에 명세서가 존재해야 합니다docs/user-stories/ 디렉토리에 사용자 스토리가 존재해야 합니다명세서 분석
docs/specs/*.md 파일들을 분석하여:
- 필요한 기술 스택 파악
- 시스템 구성 요소 식별
- 통합 포인트 확인
기술 스택 결정
파일 위치: docs/architecture/ARCHITECTURE.md
아키텍처 문서 템플릿:
# 시스템 아키텍처
## 메타데이터
- **버전**: 1.0.0
- **작성일**: {날짜}
- **관련 명세**: SPEC-{번호} 목록
## 1. 시스템 개요
### 1.1 아키텍처 다이어그램
{시스템 구성도 - Mermaid 또는 ASCII}
### 1.2 기술 스택
| 구분 | 기술 | 버전 | 선정 이유 |
|-----|-----|-----|---------|
| Language | {언어} | {버전} | {이유} |
| Framework | {프레임워크} | {버전} | {이유} |
| Test | {테스트 도구} | {버전} | {이유} |
| CI/CD | GitHub Actions | - | 표준화된 CI/CD |
## 2. 컴포넌트 구조
### 2.1 디렉토리 구조
{프로젝트 루트}/ ├── src/ # 소스 코드 │ ├── main/ # 메인 애플리케이션 │ └── test/ # 테스트 코드 ├── docs/ # 문서 │ ├── specs/ # 명세서 │ ├── user-stories/ # 사용자 스토리 │ └── architecture/ # 아키텍처 문서 ├── .github/ │ └── workflows/ # CI/CD 워크플로우 └── {설정 파일들}
### 2.2 모듈 설명
| 모듈명 | 역할 | 의존성 |
|-------|-----|-------|
| {모듈} | {역할} | {의존성} |
## 3. 인터페이스 정의
### 3.1 API 엔드포인트
| Method | Path | 설명 | 관련 스토리 |
|--------|------|-----|-----------|
| GET | /health | 헬스 체크 | - |
| {Method} | {Path} | {설명} | US-{번호} |
## 4. 추적성
- **관련 명세**: {SPEC ID 목록}
- **관련 스토리**: {US ID 목록}
파일 위치: .github/workflows/ci.yml
CI 파이프라인 템플릿:
name: CI Pipeline
on:
push:
branches: [main, develop]
pull_request:
branches: [main, develop]
env:
# 환경 변수 정의
jobs:
# Job 1: 빌드 및 단위 테스트
build-and-test:
name: Build & Unit Test
runs-on: ubuntu-latest
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup {언어/런타임}
uses: {setup-action}
with:
{version}: {버전}
- name: Install dependencies
run: {의존성 설치 명령}
- name: Run linter
run: {린트 명령}
- name: Run unit tests
run: {테스트 명령}
- name: Upload test results
uses: actions/upload-artifact@v4
if: always()
with:
name: test-results
path: {테스트 결과 경로}
# Job 2: 통합 테스트
integration-test:
name: Integration Test
runs-on: ubuntu-latest
needs: build-and-test
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Setup environment
run: {환경 설정}
- name: Run integration tests
run: {통합 테스트 명령}
# Job 3: E2E 테스트 (필요시)
e2e-test:
name: E2E Test
runs-on: ubuntu-latest
needs: integration-test
if: github.event_name == 'pull_request'
steps:
- name: Checkout code
uses: actions/checkout@v4
- name: Run E2E tests
run: {E2E 테스트 명령}
기본 애플리케이션과 Health Check 엔드포인트를 구현합니다.
필수 구현 항목:
메인 애플리케이션
Health Check 엔드포인트
GET /health
Response: { "status": "healthy", "timestamp": "..." }
기본 테스트
로컬 테스트 실행
# 빌드 확인
{빌드 명령}
# 테스트 실행
{테스트 명령}
# 린트 확인
{린트 명령}
GitHub Actions 검증
check-ci.sh 스크립트를 사용한 CI 결과 확인
이 스킬에는 CI 상태를 자동으로 확인하는 스크립트가 포함되어 있습니다.
스크립트 위치: skills/project-bootstrap/scripts/check-ci.sh
사용 방법:
# 스크립트 실행 (푸시 후)
./scripts/check-ci.sh
스크립트 기능:
필요 환경:
GITHUB_TOKEN 또는 GH_TOKEN 환경 변수 설정출력 예시:
[INFO] Checking CI status...
[INFO] GitHub repository: owner/repo
[INFO] Branch: main
[INFO] Commit SHA: abc1234
[INFO] Found 2 workflow(s) for commit abc1234
[INFO] Workflows:
- CI Pipeline (#12345) [in_progress]
- Lint (#12346) [completed]
[INFO] Progress: 1 completed, 1 pending (elapsed: 30s)
[INFO] All workflows completed successfully!
CI 실패 시:
[ERROR] One or more workflows failed!
[ERROR] Failed workflow: CI Pipeline (#12345)
━━━ Job: build [❌ failure] ━━━
✅ Checkout code
✅ Setup Node.js
❌ Run tests
[ERROR] Full logs: https://github.com/owner/repo/actions/runs/12345
파일 위치: docs/traceability-matrix.md
## 아키텍처 추적성 추가
| 명세서 ID | 아키텍처 컴포넌트 | API 엔드포인트 | 테스트 유형 |
|----------|-----------------|---------------|------------|
| SPEC-{번호} | {컴포넌트명} | {엔드포인트} | Unit/Integration/E2E |
이 스킬 실행 후 다음이 생성/구성됩니다:
docs/architecture/ARCHITECTURE.md - 아키텍처 설계 문서.github/workflows/ci.yml - CI 파이프라인docs/traceability-matrix.md 업데이트프로젝트 부트스트랩이 완료된 것으로 간주하는 기준:
CI 우선: 코드 작성 전에 CI 파이프라인이 정상 동작하는지 확인합니다.
최소 구현: Hello World 수준의 최소한의 코드만 작성합니다. 실제 기능 구현은 implementation 스킬에서 진행합니다.
테스트 포함: Health Check에 대한 테스트도 반드시 포함합니다.
문서화: 아키텍처 결정 사항은 모두 문서로 남깁니다.
프로젝트 부트스트랩이 완료되면:
task-planning 스킬로 구체적인 작업 계획 수립This skill should be used when the user asks to "create a hookify rule", "write a hook rule", "configure hookify", "add a hookify rule", or needs guidance on hookify rule syntax and patterns.
Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.