Codeloop — AI Autonomous Dev Loop
codeloop start 한 번이면 목표 LOC까지 AI가 알아서 개발 · sleep · 재개를 반복한다.
nowimslepe 프로젝트에서 311K LOC 달성으로 검증된 Ralph Loop 엔진을 범용 Claude Code Plugin으로 추출.
"codeloop.yaml 20줄 + PROMPT.md 한 장 = 20만 줄의 프로덕션 코드"
Install
# 1. Marketplace 등록
/plugin marketplace add https://github.com/tumblecat44/20loc-jackpot.git
# 2. 플러그인 설치
/plugin install codeloop@tumblecat44-20loc-jackpot
또는 대화형 UI에서:
/plugin
# → Discover 탭 → codeloop 선택 → 설치 범위(user/project/local) 선택
설치하면 Stop Hook이 자동 등록된다. settings.local.json을 직접 편집할 필요 없음.
Quick Start
# 1. 프로젝트 셋업 (3문답 위저드)
/codeloop-init
# 2. 루프 시작
/codeloop start
# 3. 상태 확인
/codeloop status
# 4. 루프 중지
/codeloop stop
How It Works
codeloop start
→ claude -p (PROMPT.md 주입)
→ Claude 자율 개발
→ Stop Hook 자동 발동
├─ Usage Gate (OAuth API → sleep or pass)
├─ Completion Gates (loc/iterations/budget/custom)
├─ Dashboard 갱신 (loc-status.md)
└─ 게이트 통과? → 루프 종료 : exit 0 → 반복
- 상태 파일 ON/OFF:
.claude/codeloop.state.md 존재 = 루프 ON, 삭제 = OFF
- exit 0 패턴: Stop Hook은 항상 exit 0 — 루프 제어권은 상태 파일에
- OAuth API 1순위:
fiveHourPercent 실측값으로 정확한 rate limit 관리
codeloop.yaml
project:
name: "My SaaS"
prompt: ./PROMPT.md
model: opus
gates:
- type: loc
target: 200000
- type: iterations
max: 500
usage:
threshold: 90
cooldown_seconds: 30
sleep_buffer_seconds: 60
dashboard:
path: .claude/loc-status.md
Gates
| Gate | Example | Description |
|---|
loc | target: 200000 | 누적 LOC 목표 도달 시 종료 |
iterations | max: 500 | 반복 횟수 제한 |
budget | max_usd: 50 | API 비용 한도 |
custom | command: "./my-gate.sh" | 사용자 스크립트 |
Project Structure
codeloop/
├── .claude-plugin/
│ ├── plugin.json # Plugin meta + Stop Hook 자동 등록
│ └── marketplace.json # Marketplace 등록 정보
├── hooks/
│ └── stop-hook.sh # Orchestrator
├── scripts/
│ ├── usage-gate.js # OAuth API 사용량 감지
│ ├── dashboard.sh # Markdown 대시보드
│ ├── parse-yaml.sh # YAML 파서
│ └── gates/
│ ├── loc.sh # LOC gate
│ ├── iterations.sh # Iterations gate
│ ├── budget.sh # Budget gate
│ └── custom.sh # Custom gate
└── skills/
├── codeloop/
│ └── SKILL.md # /codeloop start|stop|status
└── codeloop-init/
├── SKILL.md # /codeloop-init 위저드
└── references/
├── stacks.md
└── prompt-template.md
License
MIT
tumblecat44