AI Agent Ops Framework · Claude Code Plugin

Verify Before
You Ship.
Every Time.

AI가 코드를 빠르게 만들어줘도, 잘못된 판단 하나가 4주 뒤 전체 리팩토링으로 돌아온다.

Nova는 AI 에이전트가 안정적으로 일하도록 만드는 Agent Ops 프레임워크다. 환경·맥락·품질·협업·진화 5기둥 중 가장 강한 기둥이 독립 검증 품질 게이트다.

설치하기 (30초)GitHub
10
Auto-Apply Rules
14
Commands
6
Specialist Agents
10
Skills
terminal
# Install Nova (30 seconds)
$ claude plugin marketplace add TeamSPWK/nova
$ claude plugin install nova@nova-marketplace
# Start immediately
$ /nova:next
✓ Nova Agent Ops active — every session, automatically
scroll
The Real Problem

AI가 만든 코드의 진짜 병목

타이핑 속도가 병목이 아니다. 잘못된 판단의 복리 이자가 병목이다.

설계 병목

1주차 잘못된 판단이 4주를 날린다

AI가 코드를 빠르게 생성해도, 아키텍처 결정 하나가 잘못되면 스노우볼처럼 불어난다. 스택 트레이스가 원인을 가리키지 않을 때 팀 전체가 멈춘다.

자기 검증의 함정

"자기가 쓴 코드를 자기가 리뷰"

같은 AI가 코드를 만들고 리뷰한다. 확증 편향. jwt_secret을 하드코딩해놓고 리뷰에서 통과시킨다. 설계에서 명시한 bcrypt 해싱이 구현에 없어도 모른다.

맥락 소실

세션이 끊기면 맥락이 사라진다

AI 대화는 세션 단위다. 어제 설계한 결정, 발견한 Known Gaps, 완료한 스프린트 — 새 세션이 열리면 모두 초기화. 같은 실수를 반복하는 이유다.

How It Works

Generator → Nova → Done

코드를 만든 에이전트와 검증하는 에이전트는 항상 다르다.
Generator-Evaluator 분리가 핵심이다.

Generator
AI가 코드를 구현
Claude Code가 기능을 구현한다
Quality Gate
Nova
독립 Evaluator가 검증
독립 서브에이전트가 적대적 검증
Done / Fix
PASS 또는 수정 요청
PASS면 완료, 문제면 즉시 보고

Evaluator의 5차원 검증

“통과시키지 마라, 문제를 찾아라” — 적대적 자세로 5가지 기준을 독립 검증

1
기능
요구사항과 실제 동작 일치 여부
2
데이터 관통
입력→저장→표시 전 경로 완전성
3
설계 정합성
기존 코드/아키텍처 일관성
4
에러 핸들링
에러 핸들링, 엣지 케이스, 타입 안전성
5
경계값
0, 음수, 빈 값에서 크래시 없음
Five Pillars

AI Agent Ops 5기둥

Nova는 품질 게이트에서 출발했지만, 이제 에이전트가 안정적으로 일하기 위한 환경·맥락·품질·협업·진화 전체를 다룬다. 품질 기둥은 여전히 가장 강하다.

Environment

환경 — 에이전트 작업 공간

Worktree 격리, 시크릿 공유, 환경변수 연결까지 — 병렬 에이전트가 서로를 깨뜨리지 않고 일할 수 있는 운영 환경을 제공한다.

  • →Worktree 자동 셋업
  • →`.env`·`.secret/` 공유
  • →SessionStart 훅 자동 주입
Context

맥락 — 세션 연속성

NOVA-STATE.md로 진행 상태·블로커·결정 로그를 세션 간에 이어붙인다. 어제 끝낸 자리에서 오늘 그대로 시작한다.

  • →자동 갱신 체크포인트
  • →Known Gaps / Risks 추적
  • →memory 시스템과 연동
핵심 기둥
Quality · Core

품질 — Generator-Evaluator 분리

구현한 에이전트와 검증하는 에이전트는 항상 다른 서브에이전트다. 커밋 전 하드 게이트: tsc/lint 통과 → Evaluator PASS → 커밋 허용. 세션마다 자동 주입되는 유일한 전역 규칙이다.

  • →독립 서브에이전트 검증
  • →5차원 (기능·데이터·설계·에러·경계값)
  • →Hard-Block 자동 분류
  • →`--emergency` 예외 모드
Collaboration

협업 — 오케스트레이션 & 자문

설계→구현→검증 전체 사이클을 한 명령으로 조율하고, 결정이 갈리는 지점에서는 Claude·GPT·Gemini를 동시에 불러 교차 확인한다.

  • →/nova:auto — 풀 사이클
  • →/nova:orchestrator — CPS 설계
  • →/nova:ask — 멀티 AI 자문
Evolution

진화 — 자기 진단 & 업그레이드

코드베이스를 스캔해 다음 행동을 추천하고, 기술 동향을 반영해 Nova 자신을 안전 범위 안에서 업그레이드한다.

  • →/nova:scan — 온보딩 분석
  • →/nova:next — 다음 행동 추천
  • →/nova:evolve — 자율 진화

Nova가 잡아내는 결함

CI에서 의도적 결함 코드로 자가 검증 테스트 실행

📄GET /api/auth/me 엔드포인트 누락
설계-구현 갭
/nova:gap — 설계 문서 vs 라우트 핸들러 diff
🔒비밀번호 평문 저장
보안
설계는 bcrypt 요구, 코드에 해싱 없음 → Hard-Block
⚠️이메일 중복 체크 누락 (409 미처리)
검증 계약 불이행
설계에 409 명시, 코드에 처리 없음
🔑JWT 시크릿 키 하드코딩
보안 패턴
정적 분석: 문자열 리터럴 탐지 → Hard-Block
Live Demo

실제 Nova 사용 예시

복잡도별로 Nova가 어떻게 다르게 동작하는지 확인해보세요.

간단"NullPointerException 수정해줘"
nova — "NullPointerException 수정해줘"
14 Commands

필요할 때 직접 제어

자동 적용 규칙 위에 추가 제어가 필요할 때 사용하는 14개 커맨드.

Analyze/nova:ask
멀티 AI 다관점 자문을 실행한다. Claude + GPT + Gemini 3개 AI에게 동시에 질의하고 합의 수준을 분석한다.
Automate/nova:auto
자연어 요청을 설계→구현→검증→수정 전체 사이클로 자동 실행한다.
Analyze/nova:check
코드 품질 리뷰 + 설계-구현 정합성 검증을 한 번에 수행한다. — MUST TRIGGER: 커밋 전(3파일 이상 변경 시), 스프린트 완료 시, 사용자가 버그를 보고한 직후.
Analyze/nova:deepplan
Explorer→Synth→Critic→Refiner 4단 파이프라인으로 깊이 있는 Plan 문서를 생성한다.
Plan/nova:design
CPS(Context-Problem-Solution) 프레임워크로 Design 문서를 작성한다.
Automate/nova:evolve
기술 동향을 스캔하고 Nova를 자동으로 진화시킨다. 사용자 대신 Nova 품질 게이트가 변경을 검증한다.
Analyze/nova:next
현재 프로젝트 상태를 진단하고 다음에 실행할 Nova 커맨드를 추천한다.
Plan/nova:plan
CPS(Context-Problem-Solution) 프레임워크로 Plan 문서를 작성한다.
Verify/nova:review
코드를 적대적 관점에서 리뷰하고, 숨겨진 문제를 찾아낸다. — MUST TRIGGER: 커밋 전(로직 변경 시), PR 생성 전, 버그 수정 후 회귀 확인 시.
Analyze/nova:run
구현→검증을 한 사이클로 실행한다 (Full Cycle). --verify-only로 검증만 수행 가능.
Analyze/nova:scan
새 프로젝트에 처음 투입됐을 때 코드베이스를 자동 분석하고 '어디부터 볼지' 브리핑한다.
Analyze/nova:setup
새 프로젝트에 Nova Quality Gate를 초기 설정하거나, 기존 프로젝트의 갭을 자동 보완한다 (--upgrade).
Verify/nova:ux-audit
5인 적대적 평가자로 UI/UX를 다관점 심층 평가. 접근성(WCAG 2.2)·인지 부하·성능(Core Web Vitals)·다크 패턴(EU DSA)까지 코드 기반 분석.
Analyze/nova:worktree-setup
현재 worktree에서 메인 레포의 .env·시크릿·설정 파일을 즉시 심볼릭 링크한다. SessionStart 자동 훅의 수동 재시도 버전.
Orbit

멀티 에이전트 오케스트레이션

자연어 한 줄로 설계→구현→검증 전체 사이클을 실행한다. 역할별 전문 에이전트가 병렬로 작업하고, 독립 Evaluator가 품질을 보장한다.

bash
npx nova-orbit
GitHub에서 보기

역할별 전문 에이전트

Architect

시스템 아키텍처 설계, 기술 선택, 확장성·유지보수성 검토

Senior Dev

코드 품질 개선, 리팩토링, 구현 전략, 기술 부채 식별

QA Engineer

테스트 전략 수립, 엣지 케이스 식별, 품질 검증

Security Engineer

보안 취약점 점검, 위협 모델링, 인증·인가 검토

DevOps Engineer

CI/CD 파이프라인, 인프라 설정, 배포 전략, 모니터링

핵심 기능

Kanban

Kanban 보드

드래그앤드롭으로 태스크를 관리하고, AI 에이전트에게 실시간 할당한다. 진행 상황을 한눈에 파악.

  • →태스크 생성 및 할당
  • →에이전트별 진행 추적
  • →우선순위 자동 정렬
Goal

Goal 분해

자연어로 목표를 입력하면 실행 가능한 태스크로 자동 분할한다. 복잡한 프로젝트도 한 줄로 시작.

  • →자연어 → 태스크 자동 분할
  • →의존성 그래프 생성
  • →예상 소요시간 추정
GitHub

GitHub 연동

레포 클론부터 브랜치 전략, PR 생성까지 GitHub 워크플로를 에이전트가 직접 수행한다.

  • →레포 클론 및 브랜치 관리
  • →자동 PR 생성 및 리뷰
  • →이슈 트래킹 연동
Quality

Quality Gate 통합

Nova의 Generator-Evaluator 패턴을 내장. 5차원 검증으로 에이전트 산출물의 품질을 자동 보장한다.

  • →Generator-Evaluator 분리
  • →5차원 품질 검증
  • →커밋 전 하드 게이트

왜 Orbit인가?

Orbit
단일 AI
수동
에이전트 역할 분리
지원
미지원
미지원
독립 검증 (Evaluator)
지원
미지원
지원
자동 복잡도 판단
지원
미지원
미지원
병렬 작업 실행
지원
미지원
미지원
스프린트 분할·추적
지원
미지원
지원
설계-구현 갭 탐지
지원
미지원
지원
nova orchestrate
MCP Server

어디서든 Nova 규칙에 접근

MCP(Model Context Protocol) 서버로 Nova의 규칙과 도구를 어느 Claude Code 세션에서든 사용할 수 있습니다. Nova가 설치되지 않은 프로젝트에서도 동작합니다.

MCP가 뭔가요?

MCP(Model Context Protocol)는 AI 모델이 외부 도구에 접근하는 표준 프로토콜입니다. Nova의 MCP 서버는 로컬에서 실행되며, Claude Code가 Nova의 규칙·상태·검증 도구를 직접 호출할 수 있게 합니다. API 호출이나 외부 서버 연결 없이, 로컬 파일만 읽습니다.

어떻게 동작하나요?

어느 프로젝트든→Claude Code→Nova MCP
get_rules() → Nova 규칙 전문
get_state() → NOVA-STATE.md
verify() → 코드 검증 실행
orchestrate() → 오케스트레이션 실행

제공 도구 (6개)

get_rulesNova 규칙 조회

전체 또는 섹션별(§1~§9) 규칙 반환

get_commands커맨드 목록 조회

13개 슬래시 커맨드와 설명

get_stateNOVA-STATE.md 기반 상태 조회 (advisory 포함)

NOVA-STATE.md 읽기 + advisory 메시지 반환

verify코드 검증 실행

Lite/Standard/Full 강도별 코드 품질 검증

orchestrate오케스트레이션 실행

자연어 요청 → 설계→구현→검증 전체 사이클 실행

create_planCPS 플랜 생성

주제를 입력하면 CPS 형식 Plan 초안 반환

bash
# Nova 플러그인 설치 시 MCP 서버도 함께 포함됩니다.
# 별도 설정 없이 바로 사용 가능합니다.

claude plugin marketplace add TeamSPWK/nova
claude plugin install nova@nova-marketplace

# MCP 도구 확인
# Claude Code 세션에서 자동으로 사용 가능

플러그인 설치만으로 MCP 서버가 자동 활성화됩니다. 별도 빌드나 설정이 필요 없습니다.

Quick Install

30초면 설치 완료

두 줄 명령어로 Nova Quality Gate가 모든 Claude Code 세션에 활성화됩니다.

⚡
30초 설치
두 줄 명령어로 즉시 설치
🔑
API 키 불필요
/nova:xv 제외 모든 기능 무료
🔄
자동 적용
설치 즉시 모든 대화에 활성화
🛡
MIT 라이선스
오픈소스, 상업적 사용 가능
1

Install

bash
# Install (30 seconds)
claude plugin marketplace add TeamSPWK/nova
claude plugin install nova@nova-marketplace

# Start
/nova:next   # 다음 할 일 확인
2

Update / Remove (optional)

bash
# Update
claude plugin update nova@nova-marketplace

# Remove
claude plugin uninstall nova@nova-marketplace
claude plugin marketplace remove nova-marketplace

Requirements

  • ✓Claude Code CLI (필수)
  • ○OpenAI + Google AI Studio API 키 (선택, /nova:consult 사용 시만 필요)
GitHub에서 시작하기

MIT 오픈소스 · 무료

처음이신가요? 인터랙티브 가이드로 체험해보세요
FAQ

자주 묻는 질문

Nova에 대해 더 궁금한 점은 GitHub에서 확인하세요.