fullstack-coding-standards

Fullstack Coding Standards - 통합 패키지

포함 파일

fullstack-coding-standards/
├── SKILL.md                    # 이 파일 (상세 코드 예시)
├── references/                 # 핵심 규칙 (명시적 로드)
│   └── rules.md                # 스킬 호출 시 읽는 규칙 본문
└── templates/                  # 코드 템플릿

참조 로딩 규칙

1. 이 SKILL.md를 워크플로와 예시의 소유자로 사용합니다.
2. 스킬을 명시적으로 호출했을 때 references/rules.md를 읽고 현재 프로젝트에 필요한 규칙만 적용합니다.
3. Java/Spring Boot 또는 DB 연동 상세가 필요할 때만 해당 templates/ 파일을 추가로 읽습니다.

이 규칙 본문은 스킬 안의 참조 문서이며 커스텀 에이전트로 등록되지 않습니다.

프론트엔드 코드 예시

apiClient.ts (fetch 래퍼)

// src/lib/apiClient.ts
const API_BASE_URL = import.meta.env.VITE_API_URL || '/api';

class ApiClient {
  private baseUrl: string;

  constructor(baseUrl: string) {
    this.baseUrl = baseUrl;
  }

  private async request<T>(endpoint: string, options?: RequestInit): Promise<T> {
    const url = `${this.baseUrl}${endpoint}`;
    const response = await fetch(url, {
      headers: {
        'Content-Type': 'application/json',
        ...this.getAuthHeaders(),
      },
      ...options,
    });

    if (!response.ok) {
      if (response.status === 401) {
        window.location.href = '/login';
        throw new ApiError(401, 'Unauthorized');
      }
      throw new ApiError(response.status, await response.text());
    }

    return response.json();
  }

  private getAuthHeaders(): Record<string, string> {
    const token = localStorage.getItem('accessToken');
    return token ? { Authorization: `Bearer ${token}` } : {};
  }

  get<T>(endpoint: string) { return this.request<T>(endpoint); }
  post<T>(endpoint: string, data: unknown) {
    return this.request<T>(endpoint, { method: 'POST', body: JSON.stringify(data) });
  }
  put<T>(endpoint: string, data: unknown) {
    return this.request<T>(endpoint, { method: 'PUT', body: JSON.stringify(data) });
  }
  delete<T>(endpoint: string) {
    return this.request<T>(endpoint, { method: 'DELETE' });
  }
}

export const apiClient = new ApiClient(API_BASE_URL);