EveryInc/compound-engineering-plugin

컴파운드 엔지니어링이란 무엇인가요?

컴파운드 엔지니어링은 코드 중심 AI 어시스턴트(Claude Code, Cursor, Codex, Grok 등)를 위한 AI 에이전트 플러그인으로, 즉시 사용 가능한 36개의 스킬을 제공합니다. 이 플러그인은 개발 주기를 반복 가능한 루프인 브레인스토밍 → 계획 → 작업 → 단순화 → 리뷰 → 컴파운드로 구조화하고, 각 변경 사항에서 얻은 교훈을 자동으로 리포지토리에 기록하여 다음 반복이 이미 그 지식을 내재한 상태에서 시작되도록 합니다.

핵심 아이디어 – 컴파운드 루프

단계	스킬	기능
브레인스토밍	`/ce‑brainstorm`	순수한 요구사항을 추출하고 통합된 "요구사항 전용" 계획을 만드는 대화형 Q&A입니다.
계획	`/ce‑plan`	브레인스토밍 결과를 실행 가능한 구체적인 구현 계획으로 전환합니다.
작업	`/ce‑work`	계획을 직접 실행하거나 다중 모델 저자에게 위임하며 커밋과 검증을 처리합니다.
단순화	`/ce‑simplify‑code`	리뷰 전에 새로 작성된 코드를 명확성과 재사용성을 위해 리팩터링합니다.
리뷰	`/ce‑code‑review` (및 `/ce‑doc‑review`)	다중 에이전트 기반의 보고서 전용 리뷰로, 구현이 계획과 일치하는지 확인합니다.
컴파운드	`/ce‑compound`	사이클 동안 발견한 통찰, 제약 조건, 패턴을 `docs/solutions/` (또는 사용자 지정 위치)에 지속적으로 저장합니다.

루프를 한 번 실행하면 학습 아티팩트가 생성되며, 두 번째 실행부터는 이 아티팩트를 기반으로 하므로 에이전트는 과거의 수정 사항, 에지 케이스, 아키텍처 결정을 "기억"하게 됩니다.

사용 방법

설치: 선호하는 AI 코딩 호스트(Claude Code, Cursor, Codex, Grok 등)에 플러그인을 설치합니다. README에는 각 플랫폼별 정확한 명령어가 제공되며, 대부분은 /plugin marketplace add EveryInc/compound-engineering-plugin 또는 codex plugin add compound‑engineering@compound‑engineering‑plugin와 같은 단일 명령어로 완료됩니다.
어떤 리포지토리에서든 설정 명령어를 실행합니다:
```
/ce‑setup
```
이 명령어는 .compound‑engineering/config.yaml을 생성하고, 예제 아티팩트를 추가하며, .gitignore를 업데이트합니다.

루프를 수동으로 실행합니다:

/ce‑brainstorm <기능 설명>
/ce‑plan
/ce‑work
/ce‑simplify‑code
/ce‑code‑review
/ce‑compound

또는 브레인스토밍 후 자율 스킬 lfg("let‑f‑go")에 전체 파이프라인을 위임할 수 있습니다:
```
/ce‑brainstorm 기능을 설명
/lfg
```
lfg는 전체 루프를 실행하고, 원격 저장소가 존재하면 PR을 푸시하며 CI를 모니터링하고, 명시적으로 승인하지 않는 한 병합을 멈춥니다.

스킬 카탈로그 (고수준 그룹)

그룹	대표 스킬	목적
핵심 루프	`ce‑brainstorm`, `ce‑plan`, `ce‑work`, `ce‑simplify‑code`, `ce‑code‑review`, `ce‑compound`	모든 반복을 구성하는 6단계입니다.
루프 주변	`ce‑strategy`, `ce‑product‑pulse`, `ce‑sweep`, `ce‑compound‑refresh`	루프가 고위 목표와 기존 지식 팩에 기반하도록 유지합니다.
요청 시	`ce‑ideate`, `ce‑bakeoff`, `ce‑pov`, `ce‑debug`, `ce‑explain`, `ce‑doc‑review`, `ce‑optimize`, `ce‑prototype`	디버깅, 설명, 프로토타이핑 등 특정 필요에 맞는 빠른 유틸리티입니다.
Git 워크플로우	`ce‑commit`, `ce‑commit‑push‑pr`, `ce‑babysit‑pr`, `ce‑resolve‑pr‑feedback`, `ce‑worktree`	커밋, PR 생성, 피드백 관리 등을 자동화합니다.
자율	`lfg`	전체 파이프라인을 손 놓고 실행합니다.
테스트 및 디자인	`ce‑test‑browser`, `ce‑test‑xcode`, `ce‑polish`, `ce‑dogfood`	출력물의 검증과 마무리 작업을 수행합니다.
협업	`ce‑proof`, `ce‑handoff`, `ce‑promote`	작업 공유 및 소유권 이전을 지원합니다.
유틸리티	`ce‑setup`, `ce‑noslop`, `wtf`, `ce‑retune`, `ce‑riffrec‑feedback‑analysis`	설정, 작성, 유지보수를 위한 다양한 보조 도구입니다.

철학

다음 작업을 더 쉽게 만든다 – 지식은 커밋 기록에 묻히지 않고 캡처된다.
80% 계획 및 리뷰, 20% 실행 – 충분한 사전 고민을 통해 기술적 부채와 반복 학습을 줄인다.
컴파운드 팩 (실험적) – 조직 전체의 규칙 세트를 정의할 수 있으며, 계획 시 자동으로 참조되고 리뷰 시 강제 적용되어 리포지토리 간 일관성을 확보할 수 있다.

다양한 생태계에서의 설치

이 리포지토리는 Claude Code, Cursor, Codex CLI, Kimi, Cline, Grok Build, Devin, GitHub Copilot, Factory Droid, Qwen Code, OpenCode, Pi, oh‑my‑pi, Antigravity 등 수십 가지 에이전트에 대해 네이티브 매니페스트를 제공합니다. 설치는 일반적으로 리포지토리를 마켓플레이스 소스로 등록한 후 compound‑engineering 플러그인을 설치하는 단일 명령어로 완료됩니다. 각 플랫폼별 상세 절차는 README에 기재되어 있으며, 패턴은 동일합니다:

마켓플레이스 등록 (필요 시).
플러그인 설치.
새 /skill 명령어가 나타나도록 에이전트를 재시작하거나 다시 로드합니다.

빠르게 시작하기

/ce‑setup               # 리포지토리에 설정을 부트스트랩
/ce‑brainstorm 백그라운드 작업 재시도를 더 안전하게 만들기
/ce‑plan
/ce‑work
/ce‑simplify‑code
/ce‑code‑review
/ce‑compound

또는 완전 자율 모드:

/ce‑brainstorm 기능 설명
/lfg

플러그인은 PR을 생성하고 테스트를 실행하며, 승인하지 않으면 병합 전에 중단합니다.

더 알아보기

스킬 문서 – docs/guides/README.md (완전한 카탈로그, 체이닝 다이어그램).
블로그 포스트 – "컴파운드 엔지니어링: Every이 에이전트로 코드하는 방법"과 "컴파운드 엔지니어링의 배경 이야기" (README 내 링크).
데모 자산 – assets/demo/는 2주간의 실제 세션을 재생한 것으로, 지식의 컴파운드 효과를 보여줍니다.

요약

컴파운드 엔지니어링은 실제 설치 가능한 플러그인으로, AI 코딩 에이전트를 자가 문서화된 개발 보조 도구로 바꿉니다. 모든 변경 사항을 구조화된 루프를 거치고 학습된 교훈을 지속적으로 저장함으로써, 기술적 부채를 줄이고 미래 작업을 더 빠르고 안전하게 만들고자 합니다.