Compound Engineering: Codex Skills를 사용해서 도입해보기

~/.agents/skills/
├── README.md
├── ce-router/
├── ce-plan/
├── ce-work/
├── ce-review/
└── ce-compound/

## 이 키트의 스킬 구성
- ce-router (게이트/라우팅) ✅ implicit 허용 (가능한 자동 개입)
- ce-plan (PLAN 산출물)
- ce-work (WORK 실행 + Work Log 강제)
- ce-review (리뷰 + P1/P2/P3)
- ce-compound (축적물 최소 1개 강제)

---
name: ce-router
description: |
  사용자의 요청이 PLAN/WORK/REVIEW/COMPOUND 중 어느 단계인지 불명확하거나,
  승인된 PLAN 없이 구현/수정/테스트 실행을 요구하는 경우,
  Compound Engineering 루프 준수(PLAN→WORK→REVIEW→COMPOUND)와 승인 게이트를 강제한다.
  특히 "구현해줘/고쳐줘/리팩터링/테스트 돌려줘/배포해줘" 같은 요청에서 먼저 개입해
  (1) 현재 단계 (2) 승인 상태 (3) 다음으로 호출할 단계 스킬을 안내한다.
---

## 기본 규칙
- 모든 답변은 한국어로 작성한다.
- 코드 주석은 항상 한국어로 작성한다.
- 1인 개발 전제이며, 최종 결정 권한은 사용자에게 있다.
- AI는 설계→구현→테스트→문서화를 주도하되, 단계 전환은 사용자의 명시적 승인 후 진행한다.
  - 단, 사용자가 "중간 확인 없이 끝까지 진행"을 명시한 경우는 예외로 한다.

## 라우팅 목표
- 사용자 요청을 아래 중 정확히 1개 단계로 분류한다.
  - PLAN / WORK / REVIEW / COMPOUND
- 분류에 필요한 정보가 부족하면 질문은 1~3개만 한다(고레버리지 질문만).

## 승인 게이트(강제)
- 승인된 PLAN 없이 WORK로 진행하지 않는다.
- 승인된 PLAN이 있어도, 사용자가 단계 전환 승인을 하지 않았다면:
  - "다음 단계로 진행해도 되는지" 1문장으로 승인 요청 후 멈춘다.
- 사용자가 "중간 확인 없이 끝까지 진행"을 명시한 경우:
  - 단, Plan Drift(범위/정책/불변식 변경)가 발생하면 즉시 중단하고 1~3개 질문으로 승인 재확인을 한다.

## 출력 형식(강제)
1) 현재 상태 요약 (3~6줄)
   - 내가 이해한 작업 목표
   - 현재 단계(추정 또는 확인 필요)
   - 승인/위임 상태(확인 필요 여부)
2) 지금 필요한 단계 1개 + 이유
3) (필요한 경우에만) 질문 1~3개
4) 다음 단계 실행을 위한 입력 블록 템플릿
   - 사용자가 그대로 복붙해 채워 넣을 수 있게 제공
5) 마지막 한 줄: `CE 라우팅 완료`

---
name: ce-plan
description: |
  Compound Engineering의 PLAN 단계 산출물을 작성한다.
  구현/코드 수정/테스트 실행 없이, 목표/범위/DoD/결함 매트릭스/불변식/정책/체크리스트/테스트계획/리스크를 포함한 고품질 PLAN을 만든다.
  불확실하면 질문 1~3개만 한다.
---

## 모드 고정
- PLAN 전용.
- 구현/코드 수정/테스트 실행 금지.
- 증거 없는 추정 금지(근거 없으면 "가정"으로 명시하고 승인 항목으로 올린다).

## 입력(사용자 제공)
사용자가 아래 형식 중 가능한 만큼 제공한다. 누락이 크면 질문 1~3개만 한다.
- 프로젝트명:
- 스택/런타임:
- 작업 ID:
- 작업명:
- 현재 단계: PLAN
- SoT/참고 파일(선택): (경로 리스트)
- 해결 대상 결함/요구: (리스트)
- 고정 정책: (리스트)
- 범위 제한: 포함 / 제외
- 불변식: (리스트)
- (선택) 관련 코드 힌트: 파일 경로/모듈명/엔드포인트 등

## 품질 기준(내부 체크리스트)
- First Principles: 요구를 원자 단위로 재정의
- Invariants First: 불변식을 먼저 보호 전략으로 고정
- Failure-Oriented: 실패/예외/경계부터 설계
- Minimal Complexity: 가장 단순한 접근부터
- Tight Loop: 단계별 검증 루프를 촘촘히
- Observability: 로그/메트릭/에러 메시지 개선 포인트 포함

## 근거 규칙(강제)
- 가능하면 모든 주장/판단에 대해 "파일 경로 + 라인 범위" 근거를 붙인다.
- 근거를 아직 확인할 수 없으면:
  - (1) 미확인 근거
  - (2) 확인해야 할 파일 후보
  - (3) 확인 커맨드/방법
  을 PLAN에 명시한다.

## 출력 형식(강제)
아래 13개 섹션을 반드시 포함한다(순서 유지).

1) 목표/범위/비범위
2) 결함(또는 요구) 매트릭스
3) 불변식 보호 전략
4) 정책 결정 테이블
5) 완료 기준(DoD: 측정 가능)
6) 변경 대상 파일 후보 + 이유
7) 단계별 Work 체크리스트(W1~Wn, 단계별 검증 커맨드)
8) 테스트 계획(Red→Green 분리, 정상/실패/경계)
9) 리스크/회귀(P1/P2/P3) + 대응
   - P1: 데이터/보안/크래시/치명 회귀
   - P2: 내구성/중요 품질/사용성 큰 영향
   - P3: 문서/정리/개선(후속 가능)
10) Plan Drift 규칙(중단/승인 조건)
11) Review 우선순위 기준
12) Compound 후보(최소 1개)
13) 사용자 승인 필요 항목(1~3개)

### 최상단 요약(필수)
- 문서 맨 위에 "핵심 요약 5줄 이내"를 붙인다.

### 최하단 센티넬(필수)
- 마지막 한 줄: `PLAN 작성 완료 — WORK 진행 승인 요청`

---
name: ce-work
description: |
  승인된 PLAN을 기준으로 WORK 단계를 수행한다.
  체크리스트 1항목 완료→검증(가능한 범위)→의미 있는 커밋을 기본 단위로 강제하며,
  Work Log를 남긴다. Plan Drift 발생 시 즉시 중단하고 승인 요청한다.
---

## 사전조건(게이트)
- 승인된 PLAN이 없으면 WORK를 진행하지 않는다.
  - 대신: 필요한 정보 1~3개 질문 → 또는 $ce-plan 실행을 안내한다.
- 사용자가 "중간 확인 없이 끝까지 진행"을 명시한 경우만 예외로 연속 진행한다.
  - 단, Plan Drift 발생 시에는 즉시 중단하고 승인 재확인을 한다.

## 기본 규칙
- 모든 답변은 한국어.
- 코드 주석은 항상 한국어.
- PLAN 범위 밖 작업 금지.
- "의미 있는 완료 단위 커밋" 원칙 강제(커밋 메시지: 무엇/왜 포함).

## 입력(사용자 제공)
- 작업 ID:
- 작업명:
- 현재 단계: WORK
- 승인된 PLAN: (문서 경로 또는 본문 요약 붙여넣기)
- (있으면) 브랜치/PR 전략:
- (프로젝트 루트 AGENTS.md 기준) 실행/테스트 커맨드:

## 진행 단위(강제)
1) 체크리스트 1항목 선택
2) 구현(PLAN 범위 내)
3) 검증(가능한 범위: 테스트/린트/타입체크/수동 시나리오)
4) 커밋(무엇/왜 포함)
5) Work Log 업데이트

## Plan Drift 처리(필수)
- 아래 중 하나라도 발생하면 "즉시 중단":
  - 범위 변경(포함/제외가 뒤바뀜)
  - 고정 정책 위반 가능성
  - 불변식 훼손 가능성
  - DoD 재정의 필요
- 중단 시 반드시 제공:
  - 변경 전/후
  - 변경 이유
  - 영향(P1/P2/P3)
  - 대안 1~2개
  - 사용자 승인 요청(1문장)

## Work Log(강제)
- WORK 종료 시 아래 중 최소 1개는 반드시 남긴다.
  - docs/plans/<작업id>-worklog.md 생성
  - 또는 docs/plans/<작업id>-plan.md 하단에 `## Work Log` 섹션 추가

### Work Log 최소 포함 항목
- 진행 요약(3~7줄)
- 실제 변경 파일 목록(최종)
- 체크리스트 진행 상황(완료 [x])
- 실행한 검증 커맨드와 결과(실행한 것만)
- 커밋 해시 또는 PR 번호/링크
- Work 종료 3줄:
  - 이번 Work에서 완료된 체크리스트 항목:
  - 지금 상태에서 통과한 검증:
  - Review에서 집중적으로 봐야 할 위험 지점(있으면):

## 출력 형식(권장, 운영용)
- 이번 턴에서 완료한 체크리스트 항목
- 변경 파일 목록 + 핵심 변경 이유
- 실행한 검증 커맨드/결과
- Work Log 업데이트 요약
- 다음 체크리스트 제안
- 마지막 한 줄: `WORK 진행 상태 공유 완료 — 다음 단계 승인 요청`

---
name: ce-review
description: |
  WORK 이후 REVIEW 단계를 수행한다.
  자기 PR 리뷰를 선행하고, 버그/엣지/리스크/회귀/가독성 순으로 점검하며
  P1/P2/P3로 이슈를 분류하고, 이번 PR에서 처리 범위를 사용자가 결정할 수 있게 요약한다.
---

## 입력
- 작업 ID:
- 작업명:
- 현재 단계: REVIEW
- 승인된 PLAN(경로 또는 요약):
- 변경 요약(가능하면):
- 커밋/PR 식별자(가능하면):
- 실행한 검증 결과(가능하면):

## 리뷰 우선순위(강제)
1) 버그 가능성 / 엣지 케이스
2) 리스크(보안, 데이터 손상, 성능, 운영)
3) 회귀 가능성(기존 기능 영향)
4) 가독성/유지보수성

## 이슈 분류 기준(강제)
- P1: 반드시 지금 수정(데이터/보안/크래시/치명 회귀)
- P2: 가능하면 이번에 수정(사용성/내구성/중요 품질)
- P3: 문서/정리/개선(후속 가능)

## 근거 규칙(강제)
- 가능하면 "파일 경로 + 라인 범위"로 근거를 붙인다.
- 근거 확인이 안 되면 "근거 미확인"으로 표기하고, 확인해야 할 파일/라인 후보를 적는다.

## 출력 형식(강제)
1) 변경 요약(3~7줄)
2) DoD 충족 여부 체크(PLAN의 DoD 항목별)
3) P1 / P2 / P3 이슈 리스트
   - 각 항목: 증상 / 영향 / 재현 또는 조건 / 근거(파일:라인) / 권장 수정
4) 추가 테스트/관측 포인트(정상/실패/경계)
5) 사용자 결정 필요 항목(1~3개)
6) 마지막 한 줄: `REVIEW 완료 — 다음 단계(COMPOUND 또는 추가 WORK) 승인 요청`

---
name: ce-compound
description: |
  COMPOUND 단계를 수행한다.
  매 작업 종료 시 다음 작업을 더 쉽게 만드는 축적물(테스트/문서/가드레일/규칙/관측성) 최소 1개를 남긴다.
  "자동으로 잡히는가?" 자문에 답하고, 아니면 더 쉽게 찾게 만드는 문서/로그/체크리스트를 남긴다.
---

## 입력
- 작업 ID:
- 작업명:
- 현재 단계: COMPOUND
- 최종 변경 내용 요약:
- 남길 축적물 후보(있으면):

## 강제 규칙
- 축적물 최소 1개는 반드시 제안한다(가능하면 즉시 추가 가능한 형태로).
- 아래 질문에 반드시 답한다:
  - 같은 문제가 다시 생기면, 다음엔 테스트/규칙/가드레일이 자동으로 잡아줄까?
  - 아니라면, 다음에 더 쉽게 찾게 무엇을 남길까?

## 산출물 권장 경로
- docs/solutions/<slug>.md (권장)
- 또는:
  - 회귀 테스트 추가
  - AGENTS.md 규칙 강화(짧고 강한 규칙)
  - 리뷰 체크리스트 업데이트
  - 관측성 개선(로그/에러 메시지/트레이싱 포인트)

## 출력 형식(강제)
1) 축적물 후보 1~3개(우선순위)
2) 그중 최소 1개는 "바로 추가 가능한 형태"
   - 파일 경로 제안 + 문서/테스트 스켈레톤
3) 기대 효과(다음 작업이 왜 쉬워지는지)
4) 사용자 승인 필요 항목(1~3개)
5) 마지막 한 줄: `COMPOUND 완료 — Repeat 여부 승인 요청`