AI 코딩 에이전트를 위한
엔지니어링 규율

모호한 요청 → 명확한 계획 → 검증된 구현까지.
Claude Code, Gemini CLI, Cursor, Codex에서 바로 작동합니다.

워크플로우 보기 ↓ GitHub ↗

01 ▸ 워크플로우

어떻게 동작하나요? 스킬이 체인으로 연결되어 작업을 자동으로 라우팅합니다. 당신이 해야 할 일은 무엇을 원하는지 말하는 것뿐입니다.
사용자 요청 (모호) │ ▼ ┌─────────────────────────────┐ │ clarification │ │ 모호성 해소 + 코드베이스 탐색 │ │ ───────────────────────── │ │ 복잡도 평가 (자동 라우팅) │ └──────────────┬──────────────┘ │ ┌────────┴────────┐ │ │ ▼ ▼ 단순 (5-8) 복잡 (9-15) │ │ ▼ ▼ ┌─────────────┐ ┌──────────────────┐ │plan-crafting│ │milestone-planning│ │ 계획 작성 │ │ 5개 병렬 리뷰어 │ └──────┬──────┘ └────────┬─────────┘ │ │ ▼ ▼ ┌─────────────┐ ┌──────────────────┐ │ run-plan │ │ long-run │ │ worker- │ │ 다일 오케스트레이 │ │ validator │ │ │ └──────┬──────┘ └────────┬─────────┘ │ │ ▼ │ ┌─────────────┐ │ │ review-work │◄───────────┘ │ 독립 검증 │ 각 마일스톤: └─────────────┘ plan → run → review │ ▼ [완료] ─── 독립 스킬 (언제든 호출) ─── karpathy → 코딩 전/중 가드레일 clean-ai-slop → AI 생성 코드 정리 simplify → 변경사항 품질 검토 systematic-debug → 버그/테스트 실패 rob-pike → 성능 최적화
핵심 원리: 모든 전환점에서 정보 격리가 적용됩니다. 검증자는 구현자의 의도를 모릅니다 — 오직 계획과 결과만 봅니다.

02 ▸ 스킬 맵

워크플로 스킬

Clarification
출발점 자동 라우팅

모호한 요청을 반복 질문 + 코드 탐색으로 명확한 범위로 좁힙니다. 단순/복잡을 자동 판별해 다음 스킬로 라우팅합니다.

Plan Crafting
계획 실행 가능

명확한 범위로 실행 가능한 다단계 구현 계획을 생성합니다. 모든 단계에 실제 코드가 포함됩니다 — 플레이스홀더 금지.

Run Plan
실행 Worker-Validator

Worker가 구현하고 Validator가 독립 검증합니다. 실패 시 자동 재시도, 3회 실패 시 사용자에게 에스컬레이션.

Review Work
검증 정보 격리

정보가 격리된 상태에서 계획 vs 구현을 대조 검증합니다. PASS/FAIL 이진 판정을 내립니다.

장기 실행

Milestone Planning
분해 5개 병렬 리뷰어

실현가능성, 아키텍처, 리스크, 의존성, 사용자 가치 — 5개 관점에서 동시 리뷰 후 최적화된 마일스톤 DAG를 합성합니다.

Long Run
오케스트레이션 체크포인트

며칠에 걸친 실행을 오케스트레이션합니다. 디스크 체크포인트로 크래시에서 생존하고, 병렬 마일스톤을 worktree 격리로 실행합니다.

독립 스킬

Karpathy
예방 가드레일

수술적 변경, 가정 검증, 범위 규율 — 코딩 전과 중에 LLM의 흔한 실수를 방지합니다.

Clean AI Slop
정리 6단계 패스

AI 코드의 과잉 주석, 불필요 추상화, 방어적 편집증 등을 동작 보존하면서 제거합니다. 테스트 우선, 단일 스멜 패스.

Simplify
검토 3개 병렬 에이전트

재사용, 품질, 효율성 — 3개 병렬 리뷰어가 변경된 코드를 검토하고 발견된 문제를 자동 수정합니다.

Systematic Debugging
디버깅 7단계

재현 우선 → 근본 원인 추적 → 실패 테스트 작성 → 단일 수정 → 검증. "하면서 다른 것도 고치는" 행위를 차단합니다.

Rob Pike's 5 Rules
성능 측정 우선

"느려 보여도 측정 전에는 만지지 않는다." 조기 최적화를 방지하고 데이터 기반 최적화를 강제합니다.

03 ▸ 설치

Claude Code
/plugin marketplace add tmdgusya/engineering-discipline
/plugin install engineering-discipline
Gemini CLI
gemini extensions install https://github.com/tmdgusya/engineering-discipline
Cursor
/add-plugin engineering-discipline
Codex
npx skills add tmdgusya/engineering-discipline