← 홈

운용 체계

Claude Code 위에 규칙 문서·훅·스크립트를 얹어 혼자 여러 프로젝트를 돌리는 방식입니다. 지금 실제로 쓰고 있는 것만 적었습니다.

2026-11-07 기준 · 2026-10-15판을 대체

설치 가능한 공개본은 opsmith ↗입니다. 공개본은 2026-08 스냅샷이라 이 페이지와 다른 부분이 있습니다.

한눈에

요청
  → 규칙 주입   전역 규칙 → 프로젝트 규칙 → 산출물 형식별 규칙
  → 작업 배분   작은 반복 작업: 로컬 LLM / 품질이 필요한 작업: Claude
  → 검증       되돌리기 어려운 것: 다른 벤더 모델(Codex), 반영 2회 상한
  → 사람 확인   결제 · 삭제 · 외부 발송 · 게시·배포 · 권한 변경
  → 기록       결정(ADR) · 실패 한 줄(faillog) · 프로젝트 기억(memory)

규칙은 문서로 주입한다

규칙을 스킬이나 프롬프트 습관에 맡기지 않고, 세션마다 자동으로 읽히는 문서에 둡니다. 문서는 세 층입니다.

문서 형식 도구(hwpx-edit, pptx-from-layouts 등)는 이름을 불러서 씁니다. 자동으로 발동하는 플러그인은 원치 않으면 끄는 쪽을 택했습니다.

폴더와 세션

작업 배분: 로컬 LLM과 Claude

맥에 LM Studio를 상시 띄워 두고 빠른 7B 모델과 주력 30B 모델을 씁니다. 커밋 메시지 초안, 짧은 요약, 명령 설명, 이름 짓기처럼 작고 반복되는 일은 로컬로 넘깁니다. 어려운 디버깅, 여러 파일에 걸친 변경, 설계, 검증은 넘기지 않습니다.

로컬 초안은 그대로 쓰지 않습니다. 커밋 메시지 초안은 실제 변경과 대조해 고친 뒤 사람이 승인해야 커밋됩니다. diff가 크면 로컬 모델의 문맥을 넘어 오류 문구가 출력되는데, 확인 없이 커밋하면 그 문구가 메시지가 됩니다. 그래서 출력을 확인한 뒤에 씁니다.

다른 벤더 모델로 검증한다

자기검토는 검증으로 치지 않습니다. 같은 벤더의 모델끼리는 편향을 공유하기 때문입니다. 되돌리기 어려운 변경, 설계 확정 직전, 오래 걸린 구현의 마무리에는 Codex를 읽기 전용으로 부릅니다.

이 사이트를 개편할 때도 같은 절차를 거쳤습니다. Codex는 프로젝트 소개 하나의 과장과 테스트의 우회 경로를 찾았고, 둘 다 실측으로 확인한 뒤 고쳤습니다. 반대로 스크린샷 7장 중 6장을 바꾸라는 제안은 대안 화면을 직접 비교해 보고 대부분 기각했습니다. (PR #1)

비대화형으로 실행한 Codex가 입력을 기다리며 멈추는 문제가 규칙을 만든 뒤에도 세 번 재발했습니다. 그래서 규칙을 더 쓰는 대신, 방치된 입력을 자동으로 닫는 래퍼로 고쳤습니다.

안전 게이트

결제·정산, 삭제(파일·DB·인프라), 외부 발송, 외부 게시·배포, 권한 변경은 실행 전에 반드시 사람에게 확인받습니다.

권한 설정과 명령 검사 훅이 대표적인 위험 명령을 실행 전에 묻거나 막지만, 이건 과속방지턱일 뿐 보안 경계가 아닙니다. 모든 형태를 잡을 수는 없으므로, 확인 의무는 설정과 상관없이 규칙으로 둡니다.

명령 검사 훅은 비공개 레포라고 확실히 판단할 수 있는 푸시만 그냥 통과시키고, 공개 레포이거나 판단이 서지 않으면 확인을 받습니다.

기억과 기록

더하기만 하지 않는다

쓰지 않거나 측정이 틀린 것은 걷어 냈습니다.

걷어 낸 것이유
골든셋 회귀 루프 (2026-10)기준선이 이미 높아 탐지력이 낮았고, 한 문항은 확신 있게 틀린 답에도 점수를 줬습니다. 도입 뒤 실제 실행도 없었습니다.
할 일 자동 캡처 (2026-11)AI 세션에서 할 일을 뽑아 쌓았지만 한 정리 때는 32개 중 28개가 노이즈였고, 아무도 그 목록을 보지 않았습니다. 할 일은 세션 안에서 직접 넣는 방식으로 바꿨습니다.
ccpilot 별도 레포 (2026-11)이미 운용에서 빠진 도구였습니다. 이력을 보존한 채 opsmith의 선택 모듈로 합치고 원래 레포는 아카이브했습니다.

도구

개수는 계속 바뀌어서 역할만 적습니다.

역할도구
에이전트 런타임Claude Code
세션·워크트리Orca
작업 흐름superpowers 하나로 통일 (설계 → 계획 → 구현)
검증Codex CLI (codex exec, 읽기 전용)
로컬 LLMLM Studio (빠른 7B · 주력 30B)
브라우저 확인Playwright(자기 확인), gstack(QA·버그 증거)
문서hwpx-edit(hwpx-toolkit), pptx-from-layouts
웹 디자인필요한 MCP를 프로젝트 단위로만 붙이는 디자인 레인(시범 운용)
보안 점검kesekit, Semgrep·CodeQL 정적 분석

기준일과 한계