onejaejae/pre-flight

/pre-flight — CLAUDE.md 기반 환경 안전 체크

작업을 시작하기 전에 CLAUDE.md에 명시된 안전 규칙과 환경 설정을 자동으로 검증한다. 위반 사항이 있으면 작업을 시작하지 않도록 경고한다.

Why This Exists

프로젝트마다 "절대 하면 안 되는 것"이 있다. dev DB에서 pytest를 돌리면 안 되고, main 브랜치에서 직접 작업하면 안 되고, 특정 config가 잘못되면 안 된다. 이런 규칙은 CLAUDE.md에 적혀 있지만, 매번 사람이 확인하기엔 놓치기 쉽다.

이 스킬은 CLAUDE.md를 파싱하여 안전 규칙을 추출하고, 현재 환경 상태와 대조하여 위반 여부를 자동으로 보고한다.

When to Use

| 상황 | 사용? | |------|------| | 세션 시작 시 | YES — 환경이 안전한지 확인 | | 브랜치 전환 후 | YES — 새 브랜치에서 config 상태 확인 | | pull/merge 후 | YES — 새 코드가 환경 요구사항을 바꿨을 수 있음 | | 테스트 실행 전 | YES — DB 설정이 안전한지 확인 | | 일반 코드 작성 중 | No — 과도한 사용은 불필요 |

Step 1: CLAUDE.md 파싱

프로젝트의 CLAUDE.md를 읽고 안전 규칙을 추출한다.

규칙 추출 기준

다음 패턴을 포함하는 섹션에서 규칙을 추출한다:

• IMPORTANT (대문자)
• 안전, safety, 절대, 금지, 반드시
• 사고 이력, incident
• 환경 설정 관련: cfg, config, 환경, DB, host

추출 결과 구조화

각 규칙을 다음 형태로 구조화:

Rule: {규칙 내용}
Check: {검증 방법}
Severity: BLOCK / WARN

Severity 기준:

• BLOCK: "절대", "금지", "IMPORTANT", 사고 이력이 있는 규칙 → 위반 시 작업 중단 권고
• WARN: "권장", "주의", 컨벤션 관련 → 위반 시 경고만

---

Step 2: 환경 체크 실행

추출된 규칙에 따라 실제 환경을 검증한다. 검증은 읽기 전용 — 아무것도 수정하지 않는다.

공통 체크 항목 (CLAUDE.md에서 해당 규칙 발견 시)

| 체크 | 방법 | 기대값 | |------|------|--------| | DB Host | config 파일에서 PSQL_HOST/DB_HOST 읽기 | localhost, 127.0.0.1 | | 브랜치 이름 | git branch --show-current | CLAUDE.md의 브랜치 네이밍 규칙 매치 | | 현재 브랜치 ≠ main | git branch --show-current | main/master가 아닐 것 | | Python 버전 | python --version | CLAUDE.md에 명시된 버전 | | Config 파일 gitignore | .gitignore 확인 | 민감 config가 ignore 되어 있을 것 | | 필수 서비스 | redis-cli ping, rabbitmqctl status 등 | CLAUDE.md에 명시된 서비스가 실행 중 |

동적 체크 (CLAUDE.md 내용에 따라)

CLAUDE.md에서 추출한 규칙 중 환경 검증이 가능한 것은 모두 체크한다. 예를 들어:

• "pytest는 localhost DB에서만" → config 파일에서 DB host 확인
• "Python 3.10만 지원" → python --version 확인
• "develop에서 분기" → git log로 base branch 확인

체크할 수 없는 규칙 (예: "코드 리뷰 후 머지")은 INFO로 표시만 한다.

---

Step 3: 결과 보고

상태 결정

| 조건 | 상태 | |------|------| | BLOCK 위반 0건, WARN 위반 0건 | CLEAR | | BLOCK 위반 0건, WARN 위반 1건+ | WARNING | | BLOCK 위반 1건+ | BLOCKED |

출력 형식

## Pre-flight Check: {프로젝트명}

**Status**: {CLEAR / WARNING / BLOCKED}
**Date**: {YYYY-MM-DD HH:MM}
**Rules extracted**: {N}개 from CLAUDE.md

### Results

| # | Rule | Check | Result | Severity |
|---|------|-------|--------|----------|
| 1 | DB는 localhost만 | PSQL_HOST=localhost | PASS | BLOCK |
| 2 | 브랜치 네이밍 | feature/DPT-1234-... | PASS | WARN |
| 3 | Python 3.10 | python 3.10.15 | PASS | WARN |

### {BLOCKED인 경우}
**작업을 시작하기 전에 다음을 해결하세요:**
1. {BLOCK 위반 항목 + 해결 방법}

### {WARNING인 경우}
**다음 사항을 참고하세요:**
1. {WARN 위반 항목 + 권고사항}

### {CLEAR인 경우}
환경이 안전합니다. 작업을 시작하세요.

---

Checklist Before Stopping

• [ ] CLAUDE.md를 읽고 안전 규칙을 추출했는가
• [ ] 추출된 각 규칙에 대해 환경 체크를 실행했는가
• [ ] BLOCK/WARN/PASS로 각 체크 결과를 분류했는가
• [ ] 최종 상태(CLEAR/WARNING/BLOCKED)를 정확히 산출했는가
• [ ] BLOCKED 항목에 해결 방법을 제시했는가
• [ ] 읽기 전용으로만 동작했는가 (환경 수정 없음)