Vibe Coding과 2026 AI 개발 도구 생태계: 생산성 혁명의 빛과 그림자

# core.md - 프로젝트 전체 규칙

## 코딩 스타일

- TypeScript strict 모드 사용
- 함수형 컴포넌트만 사용 (클래스 컴포넌트 금지)
- 에러 핸들링: guard clause 패턴 (early return) 사용
- 변수명: camelCase, 컴포넌트명: PascalCase

## 아키텍처 규칙

- API 라우트: /api/v1/ 접두사 사용
- 비즈니스 로직은 반드시 service 레이어에 위치
- 컴포넌트는 presentation과 container로 분리
- 상태 관리: zustand 사용 (Redux 금지)

## 테스트 규칙

- 모든 새 함수에 단위 테스트 필수
- 테스트 파일 위치: **tests**/ 디렉터리
- 최소 커버리지: 80%

## 금지 패턴

- any 타입 사용 금지
- console.log 프로덕션 코드에서 금지
- 인라인 스타일 금지 (Tailwind CSS만 사용)

# Project: E-commerce API

## Tech Stack

- Runtime: Node.js 22 + TypeScript 5.7
- Framework: Fastify 5.x
- Database: PostgreSQL 16 + Drizzle ORM
- Cache: Redis 7 (Valkey)
- Testing: Vitest + Supertest

## Architecture

- Clean Architecture: domain -> application -> infrastructure
- CQRS pattern for read/write separation
- Event sourcing for order lifecycle

## Conventions

- All API responses follow RFC 7807 Problem Details format
- Database migrations in /migrations with timestamp prefix
- Environment variables in .env.example (never commit .env)
- Error codes: E1xxx (auth), E2xxx (order), E3xxx (payment)

## Common Commands

- npm run dev: Start development server
- npm run test: Run all tests
- npm run db:migrate: Run database migrations
- npm run lint: ESLint + Prettier check

# .github/workflows/ai-code-review.yml
name: AI Code Quality Gate

on:
  pull_request:
    types: [opened, synchronize]

jobs:
  ai-code-review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Detect AI-generated changes
        id: ai-detect
        run: |
          # PR의 커밋 메시지에서 AI 도구 시그니처 탐지
          AI_COMMITS=$(git log --oneline origin/main..HEAD \
            --grep="Co-Authored-By" \
            --grep="Generated by" \
            --grep="Copilot" \
            --grep="Cursor" \
            --grep="Claude" | wc -l)
          echo "ai_commit_count=$AI_COMMITS" >> "$GITHUB_OUTPUT"

      - name: Run enhanced linting for AI code
        if: steps.ai-detect.outputs.ai_commit_count > 0
        run: |
          npm run lint:strict
          npm run type-check
          npm run test:coverage -- --min-coverage=80

      - name: Security scan (AI code tends to skip validation)
        if: steps.ai-detect.outputs.ai_commit_count > 0
        uses: github/codeql-action/analyze@v3
        with:
          queries: security-and-quality

      - name: Complexity check
        run: |
          npx complexity-report --max-cyclomatic 10 \
            --format json src/ > complexity.json

      - name: Comment review summary
        if: steps.ai-detect.outputs.ai_commit_count > 0
        uses: actions/github-script@v7
        with:
          script: |
            const message = [
              '## AI Code Review Gate',
              '',
              'This PR contains AI-assisted commits.',
              'Enhanced review checks have been applied:',
              '- Strict linting passed',
              '- Type checking passed',
              '- Test coverage >= 80%',
              '- Security scan completed',
              '- Complexity threshold verified',
            ].join('\n');
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: message
            });

# 비효과적 프롬프트 (Vague)
"사용자 인증 기능 만들어줘"

# 효과적 프롬프트 (Specific + Constrained)
"다음 요구사항으로 JWT 인증 미들웨어를 구현해줘:
- Framework: Fastify 5.x + @fastify/jwt
- Access Token: 15분 만료, RS256 알고리즘
- Refresh Token: 7일 만료, httpOnly 쿠키 저장
- 에러 응답: RFC 7807 Problem Details 형식
- guard clause 패턴으로 에러를 먼저 처리
- 단위 테스트 포함 (Vitest)
- 기존 UserService.findById()를 사용하여 사용자 조회
- 타입: src/types/auth.ts의 AuthPayload 인터페이스 사용"

[구조화된 프롬프트 템플릿]

1. 컨텍스트: 이 코드가 위치할 아키텍처와 기존 코드 참조
2. 제약조건: 사용할 라이브러리, 패턴, 금지 패턴
3. 인터페이스: 입출력 타입, 에러 형식
4. 엣지케이스: 반드시 처리해야 할 예외 상황
5. 테스트: 기대하는 테스트 범위와 프레임워크
6. 참조: 기존 코드에서 유사한 구현 파일 경로

#!/usr/bin/env python3
"""AI 생성 코드 품질 검증 스크립트"""

import ast
import sys
import json
from pathlib import Path
from dataclasses import dataclass, field


@dataclass
class AICodeIssue:
    file: str
    line: int
    category: str
    message: str
    severity: str  # "error" | "warning" | "info"


@dataclass
class ValidationResult:
    issues: list[AICodeIssue] = field(default_factory=list)
    passed: bool = True


def check_hardcoded_secrets(file_path: Path, content: str) -> list[AICodeIssue]:
    """AI가 자주 생성하는 하드코딩된 시크릿 탐지"""
    issues = []
    suspicious_patterns = [
        ("password", "하드코딩된 비밀번호 감지"),
        ("api_key", "하드코딩된 API 키 감지"),
        ("secret", "하드코딩된 시크릿 감지"),
        ("token", "하드코딩된 토큰 감지"),
    ]
    for i, line in enumerate(content.split("\n"), 1):
        for pattern, message in suspicious_patterns:
            if f'{pattern} = "' in line.lower() or f"{pattern} = '" in line.lower():
                issues.append(AICodeIssue(
                    file=str(file_path),
                    line=i,
                    category="security",
                    message=message,
                    severity="error"
                ))
    return issues


def check_missing_error_handling(file_path: Path, content: str) -> list[AICodeIssue]:
    """AI가 자주 누락하는 에러 핸들링 검사"""
    issues = []
    tree = ast.parse(content)
    for node in ast.walk(tree):
        if isinstance(node, ast.Try):
            for handler in node.handlers:
                if handler.type is None:
                    issues.append(AICodeIssue(
                        file=str(file_path),
                        line=handler.lineno,
                        category="error-handling",
                        message="bare except 사용 - 구체적 예외 타입을 명시하세요",
                        severity="warning"
                    ))
    return issues


def check_todo_comments(file_path: Path, content: str) -> list[AICodeIssue]:
    """AI가 남긴 TODO/FIXME 미완성 표시 탐지"""
    issues = []
    for i, line in enumerate(content.split("\n"), 1):
        if "TODO" in line or "FIXME" in line or "HACK" in line:
            issues.append(AICodeIssue(
                file=str(file_path),
                line=i,
                category="completeness",
                message="미완성 코드 표시가 남아있습니다",
                severity="warning"
            ))
    return issues


def validate_files(paths: list[str]) -> ValidationResult:
    result = ValidationResult()
    for path_str in paths:
        path = Path(path_str)
        if not path.suffix == ".py":
            continue
        content = path.read_text()
        result.issues.extend(check_hardcoded_secrets(path, content))
        result.issues.extend(check_missing_error_handling(path, content))
        result.issues.extend(check_todo_comments(path, content))

    error_count = sum(1 for i in result.issues if i.severity == "error")
    result.passed = error_count == 0
    return result


if __name__ == "__main__":
    files = sys.argv[1:]
    result = validate_files(files)
    report = {
        "passed": result.passed,
        "total_issues": len(result.issues),
        "issues": [
            {
                "file": i.file,
                "line": i.line,
                "category": i.category,
                "message": i.message,
                "severity": i.severity,
            }
            for i in result.issues
        ],
    }
    print(json.dumps(report, indent=2, ensure_ascii=False))
    sys.exit(0 if result.passed else 1)

[일상 코딩]
  GitHub Copilot (자동 완성) + Cursor (멀티파일 편집)

[복잡한 리팩토링/설계]
  Claude Code (200K 컨텍스트로 전체 코드베이스 이해)

[새 프로젝트 부트스트래핑]
  OpenAI Codex (샌드박스에서 병렬 에이전트 실행)

[코드 리뷰]
  AI 코드 리뷰 + 인간 리뷰 병행 (AI는 패턴 탐지, 인간은 설계 판단)