결론부터 말하면 이렇습니다. 지난 두 달 동안 제 벨로그에 쓴 글 대부분은 Claude Code 세션 여러 개를 동시에 굴리다가 생긴 사고와 그 해결이었고, 그 해결책은 전부 오픈소스 플러그인 3개에 들어 있습니다. 그런데 정작 글에는 플러그인 링크가 거의 없었습니다. 이 글은 그 빈틈을 메우는 목차입니다.
플러그인 | 한 줄 요약 | 저장소 |
|---|---|---|
guardrails | 셸 명령을 실행 전에 판정해서, yolo 모드에서도 | |
dev-loop | 목표 하나를 병렬 Claude Code 세션들로 쪼개고, Orca 위에서 감독한다. 모든 설계 결정은 위키 페이지를 근거로 댄다 | |
memory-loop | Claude Code 기억에 수명 주기를 붙인다. 틀린 기억은 저장 전에 거르고, 교정은 규칙으로 남긴다 |
셋 다 MIT, 로컬 전용이고 API 키가 필요 없습니다.
병렬 에이전트 도구는 많습니다. 그런데 직접 굴려 보니 문제는 띄우는 쪽이 아니었습니다. 띄운 다음이 문제였습니다. 워커 하나가 아무도 안 보는 권한 다이얼로그 앞에서 멈추고, 코디네이터는 그걸 모른 채 상태 파일만 폴링하고, 그렇게 97분이 지나갔습니다.
그래서 dev-loop의 orchestrate는 Orca를 1급 실행 기반으로 씁니다.
오케스트레이션 한 번이 Run 하나이고, 단계(계획·구현·재작업·머지 준비)마다 Task + Dispatch로 추적됩니다. "누가 뭘 하고 있고 끝났는지"가 추측이 아니라 조회 가능한 상태가 됩니다.
코디네이터는 폴링하지 않습니다. 워커가 보내는 worker_done / question / escalation 메일을 기다리다가 바로 깨어납니다. 워커의 막힌 질문이 몇 초 안에 도착합니다.
"살아 있나?"를 두 번 묻습니다. 터미널이 있는지, 그리고 화면이 실제로 움직이는지. 멈춘 워커는 첫 번째 질문은 몇 시간이고 통과하기 때문입니다.
웨이브 단위로 기다리지 않습니다. 의존성이 풀린 태스크는 슬롯이 비는 즉시 시작합니다.
Orca가 없으면 같은 보호 장치가 tmux 위에서 파일 기반으로 돌아갑니다.
나머지 절반은 LLM 위키입니다. 계획 단계는 분석 → 설계 → 분해 세 단계로 돌고, 단계마다 기계가 판정하는 게이트가 있습니다. 설계 결정 하나하나가 번들된 위키(10개 도메인, 359페이지)의 실제 페이지를 인용해야 하고, 그 페이지가 존재하는지 grep으로 확인합니다. 세션에서 검증된 교훈은 ★ Insight 블록으로 수확돼 리뷰를 거친 위키 PR로 돌아옵니다.
관련 글:
/plugin marketplace add choiyounggi/dev-loop
/plugin install dev-loop@dev-loop--dangerously-skip-permissions로 돌리면 확인 프롬프트가 사라집니다. 편하지만, 그 프롬프트가 유일한 안전장치였다는 뜻이기도 합니다. guardrails는 PreToolUse 훅이라 그 모드에서도 동작합니다.
차단: curl | sh 같은 설치 스크립트 파이프, dd/mkfs로 디스크 덮어쓰기, 포크 폭탄
확인 요청: rm -rf, force-push, git reset --hard, DROP/TRUNCATE, kubectl delete, 클라우드 자원 삭제, ~/.ssh 키·.env 읽기
규칙 15개는 각각 off / ask / block으로 바꿀 수 있고, 실행된 명령은 비밀값을 가린 감사 로그로 남습니다.
설치 직후 /guardrails:self-test를 실행하면, 위험한 예시 명령들을 실제로 실행하지 않고 판정 결과만 보여줍니다.
관련 글:
Claude Code는 기억을 저장할 수 있습니다. 없는 건 수명 주기입니다. 확인 안 된 추측이 사실처럼 저장되고, 잠깐 필요했던 메모는 영원히 쌓이고, 한 세션에서 배운 교훈은 다음 세션 전에 사라집니다.
저장 게이트: 저장할 때마다 단기/장기 등급과 만료일을 정합니다. 추측이 장기 기억으로 들어가지 않습니다.
만료 정리: 만료된 단기 기억은 archived/로 옮깁니다. 지우지 않습니다.
통합: 중복을 합치고 모순을 현재 사실로 정리하되, 쓰기 전에 결과를 보여주고 확인을 받습니다.
교정 → 습관: 사용자가 교정한 순간을 훅이 표시하고, habit 스킬이 그걸 매 요청마다 읽히는 HABITS.md 규칙으로 정리합니다. 이 파일은 8000바이트 / 24개 규칙 상한이 쓰기 시점에 강제됩니다. 매 요청마다 다시 읽히는 파일이라 크기가 곧 비용이기 때문입니다.
관련 글:
guardrails와 memory-loop는 groundwork 마켓플레이스에, dev-loop는 자체 마켓플레이스에 있습니다.
/plugin marketplace add choiyounggi/groundwork
/plugin install guardrails@groundwork
/plugin install memory-loop@groundwork
/plugin marketplace add choiyounggi/dev-loop
/plugin install dev-loop@dev-loop써 보고 막히는 지점이 있으면 각 저장소 이슈에 남겨 주세요.
이 글은 제 벨로그에 먼저 올린 글입니다. 원문: 두 달간 쓴 AI 에이전트 삽질기의 해결책은 전부 Claude Code 플러그인 3개에 들어 있습니다